提交生图任务（异步）

Base URL 为主站域名。

提交异步生图任务，秒回 task_id，随后用 GET /v1/images/async/{task_id} 轮询获取结果。请求体与同步接口 /v1/images/generations 完全一致。

鉴权：请求头 Authorization: Bearer <你的 APIKey>。

计费：提交时仅校验余额、不扣费；任务执行成功后按对应模型正常计费，失败不扣费。

排队与超时：每个用户处于排队 / 执行中的任务合计默认上限 20，超限返回 429；单任务执行超时默认 300 秒，超时标记为 failed，且不会自动重试。

结果：生成图片为对象存储公网直链，保留 10 天后自动清理。

支持模型：gpt-image-1、gpt-image-1.5、gpt-image-2、dall-e-3，以及 Gemini 图像模型（如 gemini-2.5-flash-image）等；不同模型支持的 size 见下方参数说明。

返回示例

① 提交成功（本接口）：

{ "task_id": "task_9f2c1a7b8e5d4f30a1b2c3d4e5f60718" }

② 轮询 GET /v1/images/async/{task_id}，status 为 succeeded 时：

{
  "task_id": "task_9f2c1a7b8e5d4f30a1b2c3d4e5f60718",
  "status": "succeeded",
  "result": { "images": ["https://file.openai-hub.net/xxx/result.png"] }
}

status 取值：queued / in_progress / succeeded / failed；failed 时返回 error 字段。

# 1) 提交生图任务，秒回 task_id curl https://api.openai-hub.net/v1/images/async/generations \ -H "Authorization: Bearer $APIKEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-image-2", "prompt": "一只戴宇航头盔的柴犬", "n": 1, "size": "1024x1024" }' # 返回：{"task_id":"task_xxx"} # 2) 用 task_id 轮询结果（status 变为 succeeded/failed 即结束） curl https://api.openai-hub.net/v1/images/async/task_xxx \ -H "Authorization: Bearer $APIKEY"

请求参数

返回响应