异步生图
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 风格 data(url 或 b64_json)。
与同步接口的区别
同步 /v1/images/generations | 异步 /v1/images/tasks | |
|---|---|---|
| 客户端等待 | 挂到出图 | 立刻拿 task_id 再轮询 |
| 模型 | 看渠道 | 仅 gpt-image-* |
| 适用 | MeiGen / Codex 等 OpenAI 兼容同步模式 | 自用 MCP / 脚本 |
Cursor MCP
工具:
generate_image:提交异步任务,立刻返回task_idcheck_image_task:查状态;完成后写入本地目录
配置示例见 MCP 生图。
限制
- 默认单任务超时约 10 分钟(服务端
IMAGE_ASYNC_TIMEOUT_SEC) - 默认并发 2(
IMAGE_ASYNC_MAX_CONCURRENT) quality/style/user可传,不支持时忽略- 非
gpt-image-*返回 400