gpt-image-2-official
- 对外同样走图片异步任务协议
- 面向需要显式控制
quality的图片生成场景 - 在通用比例与清晰度之外,额外开放
quality质量档位控制
请求鉴权
所有接口均需要使用 Bearer Token 进行认证。 获取 API Key:从平台上获取。 使用时在请求头中添加:提交任务接口
task_id,实际图片结果需要通过任务查询接口继续轮询。
请求参数
size支持:1:1、3:2、2:3、4:3、3:4、5:4、4:5、16:9、9:16、2:1、1:2、3:1、1:3、21:9、9:21。resolution支持:1k、2k、4k。quality支持:low、medium、high。- 若历史调用仍传
auto、空值或未知值,服务端会统一按low处理。 images最多支持16张,单图也使用数组传入。- 最终图片地址不由请求字段切换:请在异步查询响应的
works[].asset_url中读取。
响应
成功响应示例:任务查询接口
task_id 查询当前任务状态。任务成功后,可从结果对象里读取图片地址。
统一规则:响应体 code 为数字 200;works 始终是有序数组;处理中或失败时返回空数组。images 表示输入参考图,works 表示输出作品。完整状态和多作品示例见 异步任务查询。
响应
查询结果示例:works[].asset_url是平台稳定资源地址,不直接暴露底层原始图片 URL。- 当前生成张数限制以本页请求参数为准,但调用方始终应遍历
works。
使用示例
文生图
显式质量文生图
图生图
注意事项
- 这一页额外开放
quality参数。 - 提交成功后请使用返回的
task_id轮询任务结果。 n当前仅支持传1,参考图统一通过images数组传入。