Skip to main content
POST

认证与请求头

string
必填
生成和任务查询接口使用平台 API Key 进行 Bearer Token 认证。访问 API Key 管理页面 获取密钥。
查询任务时,使用同一平台用户的 API Key。
string
必填
提交请求使用 application/json,文生图和图生图均发送 JSON 请求体。

版本选择

请求参数

string
必填
固定值:gpt-image-2.5-ext
string
默认值:"flare"
模型版本,可选 flaresunburst
string
必填
图像生成或编辑的提示词,去除首尾空格后不能为空。图生图时,可描述参考图中需要保留和修改的内容。
string
默认值:"1K"
输出分辨率档位,可选 1K2K4K
string
默认值:"auto"
输出画面比例,可选 auto 或以下 10 种比例:1:116:99:164:33:43:22:35:44:521:9
integer
默认值:"1"
单次请求生成的图片张数,必须为 14 的整数。
string[]
参考图数组,最多 16 张。不传参考图时为文生图,传入后为图生图;参考图不增加费用。支持以下输入形式:
  • 可访问的图片 URL
  • Data URL:data:image/...;base64,...

使用示例

以下均为 POST /v1/images/generations 的 JSON 请求体,认证及推荐请求头同上。参考图示例地址需替换成真实可访问的图片 URL。

文生图

使用 Sunburst 进行图生图

多参考图与多张输出

自动比例与 4K 分辨率

查询任务结果

使用任务 ID 调用 任务查询接口

任务成功

以下任务 ID、时间、URL 和金额均为结构示例,不代表实际任务或售价。

Response

integer
响应状态码,统一格式提交成功时为 200
string
本次请求的标识,用于问题排查。
object
已受理的异步任务。