异步生图

gpt-image-* 异步任务接口与 MCP

适合生图耗时长、不想卡住客户端的场景。仅支持 gpt-image-* 模型(如 gpt-image-2)。

普通同步生图仍用:

POST /v1/images/generations

接口

提交任务

POST /v1/images/tasks
Authorization: Bearer sk-你的令牌
Content-Type: application/json
{
  "model": "gpt-image-2",
  "prompt": "a small red cube on a white background",
  "size": "1024x1024",
  "n": 1,
  "response_format": "url"
}

立刻返回:

{
  "id": "task_xxx",
  "object": "image.task",
  "status": "queued",
  "created": 1780000000,
  "model": "gpt-image-2"
}

查询任务

GET /v1/images/tasks/{task_id}
Authorization: Bearer sk-你的令牌

状态:queued / in_progress / completed / failed

完成后带 OpenAI 风格 dataurlb64_json)。

与同步接口的区别

同步 /v1/images/generations异步 /v1/images/tasks
客户端等待挂到出图立刻拿 task_id 再轮询
模型看渠道gpt-image-*
适用MeiGen / Codex 等 OpenAI 兼容同步模式自用 MCP / 脚本

Cursor MCP

工具:

  • generate_image:提交异步任务,立刻返回 task_id
  • check_image_task:查状态;完成后写入本地目录

配置示例见 MCP 生图

限制

  • 默认单任务超时约 10 分钟(服务端 IMAGE_ASYNC_TIMEOUT_SEC
  • 默认并发 2(IMAGE_ASYNC_MAX_CONCURRENT
  • quality / style / user 可传,不支持时忽略
  • gpt-image-* 返回 400

本页目录