异步生图 API (免超时模式)

在进行 4K 高精大图渲染或高并发连续提交时，底层的绘图神经扩散模型可能需要 15 秒以上的生成时间。为解决传统 HTTP 同步长连接超时断连的问题，XIMI-API 网关提供了免超时的异步生图 API 模式。

---

1. 提交异步任务

• HTTP 请求方法：POST
• 接口地址：https://api.ximi-api.cc.cd/v1/images/generations/async
• 请求头 Header：Authorization: Bearer YOUR_API_KEY

请求 Body 示例

{
  "model": "gpt-image-2",
  "prompt": "赛博朋克未来城市夜景，4K 高清极致细节",
  "size": "2848x2048",
  "n": 1
}

响应示例 (立即返回 Task ID)

{
  "task_id": "img_task_9876543210",
  "status": "queued",
  "created_at": 1722000000,
  "message": "异步任务提交成功，请通过 Task ID 轮询状态"
}

---

2. 轮询任务状态

• HTTP 请求方法：GET
• 接口地址：https://api.ximi-api.cc.cd/v1/images/generations/async/TASK_ID

任务生成中响应

{
  "task_id": "img_task_9876543210",
  "status": "running",
  "progress": 65,
  "elapsed_seconds": 6
}

任务完成响应数据

{
  "task_id": "img_task_9876543210",
  "status": "completed",
  "progress": 100,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..."
    }
  ]
}