模型名称gpt-image-2-official
  • 对外同样走图片异步任务协议
  • 面向需要显式控制 quality 的图片生成场景
  • 在通用比例与清晰度之外,额外开放 quality 质量档位控制

请求鉴权

所有接口均需要使用 Bearer Token 进行认证。 获取 API Key:从平台上获取。 使用时在请求头中添加:

提交任务接口

提交图片异步任务。接口受理成功后会立即返回 task_id,实际图片结果需要通过任务查询接口继续轮询。

请求参数

  1. size 支持:1:13:22:34:33:45:44:516:99:162:11:23:11:321:99:21
  2. resolution 支持:1k2k4k
  3. quality 支持:lowmediumhigh
  4. 若历史调用仍传 auto、空值或未知值,服务端会统一按 low 处理。
  5. images 最多支持 16 张,单图也使用数组传入。
  6. 最终图片地址不由请求字段切换:请在异步查询响应的 works[].asset_url 中读取。

响应

成功响应示例:
失败响应示例:

任务查询接口

使用提交阶段返回的 task_id 查询当前任务状态。任务成功后,可从结果对象里读取图片地址。 统一规则:响应体 code 为数字 200works 始终是有序数组;处理中或失败时返回空数组。images 表示输入参考图,works 表示输出作品。完整状态和多作品示例见 异步任务查询

响应

查询结果示例:
说明:
  1. works[].asset_url 是平台稳定资源地址,不直接暴露底层原始图片 URL。
  2. 当前生成张数限制以本页请求参数为准,但调用方始终应遍历 works

使用示例

文生图

显式质量文生图

图生图

注意事项

  1. 这一页额外开放 quality 参数。
  2. 提交成功后请使用返回的 task_id 轮询任务结果。
  3. n 当前仅支持传 1,参考图统一通过 images 数组传入。