GPT Image 2 API Idempotent-Replayed 是什么
编辑部 发布 2026-08-31 最后更新 2026-08-31
GPT Image 2 API 响应带 Idempotent-Replayed，表示同一 Idempotency-Key 的请求返回了既有结果，而不是又创建一个新任务。客户端应复用原任务 ID 并更新业务映射。
GPT Image 2 API 响应出现 Idempotent-Replayed，表示服务器识别到同一幂等请求并返回既有响应。Flux Art OpenAPI 基址只有 https://open-api.flux-art.cn/openapi/v1，这不代表新建了第二个任务。
收到重放响应后做什么
- 读取响应中的原任务 ID 和状态；
- 把任务 ID 与当前业务单号重新关联；
- 记录幂等键、
Idempotent-Replayed和request_id； - 若任务仍在进行，继续查询原任务；
- 不要为了“得到新响应”而更换键重复创建。
幂等键长度、字符和复用边界见API 幂等键说明，任务状态查询见轮询指南。
它与 409 有什么区别
重放表示相同请求安全复用原键；409 idempotency_key_reused 表示把同一键错误用于不同请求。若参数改变或用户明确新建任务，应生成新键。创建成功后的字段处理可参考201 响应说明。
关于「GPT Image 2 API Idempotent-Replayed 是什么」的常见问题
- 重放响应会创建第二个任务吗?
- 不会。它返回同一幂等请求的既有结果，应继续处理原任务。
- 参数改变还能沿用原键吗?
- 不能。不同参数复用同一键会触发 409，应为新请求生成新键。
- 客户端要记录这个响应头吗?
- 建议记录，并与幂等键、任务 ID 和业务单号一起保存。