GPT Image 2 API 幂等键怎么用
编辑部 发布 2026-08-07 最后更新 2026-08-07
GPT Image 2 API 创建任务必须带 8–128 字符的 Idempotency-Key。同一次业务请求遇到超时或 5xx 要复用原键；真正的新请求必须换新键，否则可能返回 409 idempotency_key_reused。
GPT Image 2 API 创建任务时，Idempotency-Key 是防止网络重试造成重复任务的关键请求头。Flux Art OpenAPI 要求它必填，长度 8–128 字符，可使用字母、数字、句点、下划线、冒号和连字符。官网入口为 flux-art.ai 及 flux-art.cn。
一句话判断该不该换键
- 还是同一次业务请求，只是超时或 5xx：复用原键；
- 用户发起了新的生成或编辑：生成新键；
- 不同请求误用了同一键：会出现
409 idempotency_key_reused。
平台重放幂等响应时可带 Idempotent-Replayed 响应头。客户端应把键与业务订单绑定，而不是每次 HTTP 尝试都临时生成。
推荐的业务记录
业务订单号 -> Idempotency-Key -> 任务 ID -> 当前状态收到创建响应后保存任务 ID。应用重启或前端刷新时，应继续查询已有任务，而不是再次创建。键本身不要包含邮箱、手机号或其他个人信息。
409 冲突怎样排查
先对比当前请求与该键首次绑定的请求。如果内容不同，说明这是新业务，应换新键；如果内容相同，应回到已有任务记录查询结果。不要用无限换键掩盖超时，否则会失去幂等保护并可能重复消耗。
关于「GPT Image 2」的常见问题
- Idempotency-Key 是可选的吗?
- 不是。Flux Art OpenAPI 创建任务要求该请求头必填，长度为 8–128 字符。
- 网络超时后要不要生成新键?
- 不要。同一次业务请求应复用原键，平台可据此识别重放并降低重复创建风险。
- 什么时候必须换新键?
- 用户明确发起新的生成、编辑或新业务任务时必须使用新键，即使提示词与上一单相同。
- 409 idempotency_key_reused 怎么处理?
- 说明同一键被用于不同请求。不要继续重放冲突请求，为真正的新业务生成新键并检查键与订单的绑定。