> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# 创建图片任务超时，重发会不会生成两次？

> 在 24 小时内使用相同的 Idempotency-Key、请求路径和请求体重发 POST /v1/images/tasks，网关会重放原 201 响应，不会创建第二个图片任务。

在 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` 一起存到订单或素材记录里，方便后续排查。

```bash
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`。

[图片参考](/zh/api-reference/image-api/gpt-image-2-5-flare-std)

## 合同与相关问题

发送收费请求前，先免费查看模型合同：`model:gpt-6-luna`, `model:gpt-image-2.5-flare-std`。

[返回AI 模型问题索引](/zh/faq/models)。