Skip to main content
POST
  • 异步接口:提交后立即返回 task_id,再调用 查询图片任务 获取结果。
  • 请求参数与 GPT Image 2 一致,只需更换 model。
  • 按张计费,单价由分辨率档位决定,见 模型价格。任务失败自动退款。

模型选择

GPT Image 2.5 由平台统一以高质量档位生成,无需传 quality,传入的值可能被覆盖。

鉴权

string
必填
Bearer <API Key>。在 API 密钥 页面创建。

请求参数

string
必填
gpt-image-2.5-flare 或 gpt-image-2.5-sunburst。
string
必填
图像生成或编辑的描述,支持中英文。建议说明主体、场景、构图、风格、光线,以及需要保留或修改的内容。
string
默认值:"1:1"
输出比例或精确像素尺寸。
  • 比例:1:1、3:2、2:3、4:3、3:4、5:4、4:5、16:9、9:16、2:1、1:2、21:9、9:21、3:1、1:3
  • 像素:例如 2048x1152,此时忽略 resolution
各比例在不同档位下的实际像素见 GPT Image 2 尺寸对照表。
string
默认值:"1k"
分辨率档位:1k、2k 或 4k,大小写均可。
string[]
参考图列表,传入后为图生图 / 参考图编辑模式。每项可以是公网图片 URL 或 data:image/png;base64,... 格式的 Data URL。

提交响应

integer
固定为 200。
string
固定为 submitted。
string
任务 ID,用于 查询图片任务。
string
与 task_id 相同。

使用示例

文生图
商品图精修(Sunburst)
多参考图合成

查询结果

取图方式:data[0].url。状态说明见 查询图片任务。