GPT Image 2 API 五种任务状态怎么处理
编辑部 发布 2026-08-29 最后更新 2026-08-29
GPT Image 2 API 任务状态有 queued、processing、succeeded、failed、canceled。前两种继续按节奏查询,succeeded 保存结果,failed 与 canceled 都是终止状态,应停止轮询并记录原因。
GPT Image 2 API 使用异步任务,状态包括 queued、processing、succeeded、failed 和 canceled。Flux Art OpenAPI 基址只有 https://open-api.flux-art.cn/openapi/v1,客户端应把状态机写清楚。
每种状态对应什么动作
| 状态 | 应做什么 |
|---|---|
queued | 保存任务 ID,等待后查询 |
processing | 继续按节奏轮询,不重复创建 |
succeeded | 保存结果和实际用量,结束轮询 |
failed | 保存错误与 request_id,判断能否重试 |
canceled | 记录终止状态,停止轮询 |
查询实现见任务轮询指南,批量恢复见GET /tasks 分页。
怎样防止无限轮询
把三种终止状态都写入停止条件,并为总等待时间设置业务上限。超过窗口仍未终止时,保留任务 ID、request_id 与最后状态转人工处理;错误分类参考API 错误码排查。
关于「GPT Image 2 API 五种任务状态怎么处理」的常见问题
- queued 和 processing 需要重新创建吗?
- 不需要,它们都是进行中状态,应继续查询原任务。
- failed 后应该自动创建新任务吗?
- 不应直接创建;先看错误类型和 request_id,再判断是否适合重试。
- 哪些状态应停止轮询?
- succeeded、failed、canceled 都是终止状态,应保存结果后停止。