跳转到主要内容
POST
模型名兼容提示:本接口同时兼容别名 gpt-image-2-ext,它等价于 gpt-image-2,两者可互换使用、效果一致。

Authorizations

Authorization
string
必填
所有接口均需要使用 Bearer Token 进行认证获取 API Key:访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加:

Body

model
string
默认值:"gpt-image-2"
必填
图像生成模型名称固定填写 gpt-image-2(兼容别名 gpt-image-2-ext
为兼容旧版调用,别名 gpt-image-2-ext(对应 gpt-image-2)仍可正常使用。
prompt
string
必填
图像生成的文本描述
  • 支持中英文,建议详细描述
  • 提交前会经过平台敏感词 / 安全审核,命中违规内容会直接返回错误
n
integer
默认值:"1"
生成图片张数取值范围:1 - 10
必须传入纯数字(如 1),不要加引号
size
string
默认值:"1:1"
图像生成的比例支持以下比例,也可传入 auto 由服务端自动选择合适比例:也支持直接传入像素尺寸,例如 1881x836 / 887x1774
size 传入 auto 时,默认比例为 1:1
resolution
string
默认值:"1k"
输出分辨率档位可选值:1k / 2k / 4ksize × resolution → 实际像素对应关系:
4K 支持上述 15 个比例;也可以直接通过 size 传入表格中的像素尺寸。
image_urls
array
参考图数组(OpenAI 标准字段),传入后走图生图模式
其它 OpenAI 标准字段(response_formatstyle)不支持,会被忽略。任务结果只返回 url——如需 base64 请自行下载转换。
official_fallback
boolean
默认值:"false"
是否使用官方渠道兜底
  • false:不使用(默认)
  • true:使用官方渠道

使用场景示例

文生图(最简请求)
文生图(指定比例 + 2K)
文生图(4K 输出)
文生图(多张)
图生图(参考图 = URL)
图生图(参考图 = base64)
图生图(多参考图融合,URL + base64 混填)

Response

code
integer
响应状态码
data
array
返回数据数组

查询任务结果

提交成功后返回 task_id,通过 GET /v1/tasks/{task_id} 轮询任务状态,详见 任务查询接口

成功响应示例

取图方式:data.result.images[0].url[0]

任务状态说明