GPT Image 2 API 返回 201 后做什么
编辑部 发布 2026-08-23 最后更新 2026-08-28
GPT Image 2 API 返回 201 表示异步任务已创建。客户端应保存 data.id 和 Location，随后查询任务状态直到 succeeded 或终止状态；不要把 201 当作图片已生成，也不要重复提交同一请求。
GPT Image 2 通过 Flux Art OpenAPI 创建成功后返回 201，但这只表示异步任务已建立，不表示图片已经完成。客户端应保存 data.id、Location 和幂等键，再查询任务状态；接口基址只有 https://open-api.flux-art.cn/openapi/v1。
201 响应要保存哪些字段
- data.id：任务主键，后续查询和故障恢复都要用；
- data.status：创建时通常为 queued；
- Location：服务器给出的轮询位置；
- Idempotency-Key：把当前业务请求与任务关联起来；
- request_id：出现错误或需要排查时使用。
不要把完整 API Key 写入日志。任务结果、用量和动态字段以实际响应和官方说明为准。
后续状态怎样处理
任务可能经历 queued、processing，最后进入 succeeded、failed 或 canceled。可按任务轮询指南控制查询频率；如果进程重启，可用已保存的任务 ID 或任务列表接口恢复。
同一请求收到 201 后不要再次创建。只有用户明确发起新任务或参数发生变化时，才应生成新的幂等键。
关于「GPT Image 2 API 返回 201 后做什么」的常见问题
- 201 是否代表图片已经生成?
- 不是。它表示任务创建成功，通常状态为 queued，仍需查询任务状态和结果。
- Location 头有什么用?
- 它提供后续查询位置；客户端也应持久保存响应中的 data.id，便于恢复任务。
- 客户端重启后怎样恢复查询?
- 从持久化记录读取任务 ID 和业务映射，再查询原任务；不要用重复创建代替状态恢复。