GPT Image 2 API 任务轮询指南
编辑部 发布 2026-08-07 最后更新 2026-08-07
GPT Image 2 API 创建成功后返回任务 ID，并以 queued 开始。服务端查询 GET /tasks/{id}；queued 或 processing 时等待，其余三种终态停止轮询。
GPT Image 2 API 使用异步任务模式。向 Flux Art OpenAPI 创建任务成功时，响应为 HTTP 201，data.status 初始为 queued，同时返回 data.id，响应头带 Location 轮询地址。官网入口为 flux-art.ai 及 flux-art.cn。
五种状态怎样分支
| 状态 | 含义 | 应用动作 |
|---|---|---|
queued | 已入队 | 保存记录，稍后再查 |
processing | 正在处理 | 继续等待，不重复创建 |
succeeded | 已成功 | 读取结果并结束轮询 |
failed | 已失败 | 记录错误，结束轮询 |
canceled | 已取消 | 记录终态，结束轮询 |
只有前两种状态需要继续查询，后三种都是终态。
服务端需要保存哪些字段
至少保存业务订单号、任务 ID、幂等键、当前状态、最近查询时间和结果或错误摘要。这样即使应用重启，也能从已有任务恢复查询，而不是重新创建图片。
如何避免轮询过快
Flux Art 对账户级任务读取限制为 120 次/分钟。不同任务应错开查询，遇到 429 时读取 Retry-After 并延后。不要用固定高频循环占满额度，也不要承诺生成必定在某个固定秒数内完成。
404 task_not_found 应先核对任务 ID、账户和路径；5xx 可退避后再次查询。密钥只放在服务端安全环境。创建请求与鉴权细节见API 入门教程，多任务调度可参考批量 API 流程。
关于「GPT Image 2」的常见问题
- GPT Image 2 API 有哪些任务状态?
- 共有 queued、processing、succeeded、failed 和 canceled；后三种是终态，应停止轮询。
- 创建任务成功返回什么状态码?
- Flux Art OpenAPI 资料说明创建成功返回 HTTP 201、任务 ID、queued 状态，并在响应头提供 Location。
- 轮询频率有固定值吗?
- 本文不编造固定间隔。应控制请求频率，任务读取账户级限制为 120 次/分钟，429 时遵循 Retry-After。
- 404 能一直重试吗?
- 不应盲目重试。先核对任务 ID、账户和路径，确认记录是否属于当前密钥对应的账户。