创建图片任务超时,重发会不会生成两次?
在 24 小时内使用原请求的 Idempotency-Key、相同路径和完全相同的 JSON 请求体重发 POST /v1/images/tasks,不会生成第二个任务。网关会返回首次成功保存的 201 响应,并附带 Idempotent-Replayed: true 响应头。
超时后的安全恢复步骤
- 先检查本地是否已经记录
task_id(data.id)。已有task_id时直接查询GET /v1/tasks/{task_id},不再重发创建请求。 - 未拿到
task_id、仍在 24 小时内,且首次请求携带了Idempotency-Key(不超过 255 个字符)时,用相同路径、同一个 key 和完全相同的请求体重试。 - 把
Idempotency-Key、请求体和返回的task_id一起存到订单或素材记录里,方便后续排查。
冲突与更换 Key 的边界
- 原请求处理中或参数变更(
409 idempotency_conflict):首次请求仍在处理时重发,或用同一个 key 提交不同路径或请求体,都会返回409 idempotency_conflict。需等待首次请求结束后再以完全相同的请求体重试。 - 校验失败或余额不足:网关只为
2xx响应保存幂等记录。遇到400或402后,修正请求或充值即可重新提交。 - 新任务必须换新 Key:更换商品图、修改提示词或调整参数来生成另一张图时,必须生成新的
Idempotency-Key。
合同与相关问题
发送收费请求前,先免费查看模型合同:model:gpt-6-luna, model:gpt-image-2.5-flare-std。

