跳到导航

创建图片任务超时,重发会不会生成两次?

在 24 小时内使用原请求的 Idempotency-Key、相同路径和完全相同的 JSON 请求体重发 POST /v1/images/tasks,不会生成第二个任务。网关会返回首次成功保存的 201 响应,并附带 Idempotent-Replayed: true 响应头。

超时后的安全恢复步骤

  1. 先检查本地是否已经记录 task_id(data.id)。已有 task_id 时直接查询 GET /v1/tasks/{task_id},不再重发创建请求。
  2. 未拿到 task_id、仍在 24 小时内,且首次请求携带了 Idempotency-Key(不超过 255 个字符)时,用相同路径、同一个 key 和完全相同的请求体重试。
  3. 把 Idempotency-Key、请求体和返回的 task_id 一起存到订单或素材记录里,方便后续排查。
curl -sS -X POST 'https://api.beatapi.io/v1/images/tasks' \
-H "Authorization: Bearer $BEATAPI_API_KEY" \
-H "Idempotency-Key: bg-edit-sku-1042-v1" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-image-2.5-flare-std","prompt":"Replace the background with light gray studio paper.","images":["https://example.com/product.jpg"]}'

冲突与更换 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。

返回AI 模型问题索引。