GPT-Image-2 API 模型解析指南

快速结论

• 调用入口是 POST /v1/images/generations，请在请求体中设置 model=gpt-image-2。
• 支持 prompt 文生图，也支持通过 reference_images 传参考图 URL 做参考图生成或编辑。
• 参考图只支持 URL，本地图片需要先调用上传接口，不能直接传 base64。
• 接口采用异步任务模式，先返回任务 ID，再通过图片任务状态接口查询结果。

核心能力

• 文生图：通过 prompt 提交标准图像生成任务，适合统一 API 接入。
• 参考图生成：通过 reference_images 传入图片 URL，用于风格或主体约束。
• 异步任务工作流：接口先返回任务 ID，适合队列、轮询和异步编排场景。

适用场景

• 需要通过统一网关接入标准文生图接口时。
• 需要基于参考图做风格延续或主体约束时。
• 需要把图像生成放到异步任务编排流程中时。

不适用场景

• 需要直接同步返回最终图片结果时。
• 需要直接传 base64 参考图而不经过上传接口时。

运行特性

• 提交请求后，接口先返回任务对象，而不是直接返回最终图片结果。
• 需要通过图片任务状态接口轮询 queued、in_progress、completed、failed 等状态。
• 参考图工作流要求 reference_images 使用 URL，本地文件要先上传后再传入。
• size 与 resolution 组合需要满足文档限制，否则会触发参数错误。

最小请求示例

{
  "model": "gpt-image-2",
  "prompt": "简洁高级的化妆品广告图，柔和棚拍光线，纯净背景",
  "size": "1:1",
  "resolution": "1K",
  "response_format": "url"
}

最小响应示例

{
  "id": "task_img_xxxxxxxx",
  "object": "generation.task",
  "model": "gpt-image-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1703884800,
  "metadata": {}
}

关键参数

常见错误

FAQ

1. gpt-image-2 怎么调用？
   通过 POST /v1/images/generations 调用，并在请求体中传入 model=gpt-image-2、prompt，以及按需传入 size、resolution、reference_images 等参数。
2. gpt-image-2 支持图生图吗？
   支持。你可以通过 reference_images 传入参考图 URL，让生成结果在风格或主体上参考输入图片。
3. 为什么不能直接传 base64 参考图？
   中文 docs 当前要求 reference_images 使用 URL。本地图片需要先走上传图片接口，再把返回的 URL 传入生成请求。
4. gpt-image-2 返回任务 ID 之后怎么查状态？
   使用图片任务状态接口轮询任务状态，等状态变成 completed 后，再读取返回结果中的图片输出字段。
5. 图像视频模型报错：invalid apitype: -1
   这类错误通常说明接口走错了。图像和视频模型一般不走 chat 接口，而是按对应文档发起 HTTP 任务请求，并通过任务状态接口轮询结果。排查时建议先看用户的实际请求代码、请求地址和请求体。
6. 用户进行生成图片/视频的任务时出现任务失败，但是扣款
   先让用户提供任务日志或截图，重点看是否出现了输入或输出 token 统计。如果有这类 token 记录，大概率是用户把图片/视频模型走成了 chat 接口；这不是正确用法。图片和视频模型通常是异步任务接口，需要通过 HTTP 请求先提交任务，再拿到任务 ID 轮询状态，详细以对应文档为准。

相关 API

• GPT-Image-2 图像生成
• 上传图片
• 图片任务状态