Skip to main content
POST
  • 异步接口:提交后立即返回 task_id,再调用 查询图片任务 获取结果。
  • 不传 image_urls 为文生图;传入 image_urls 自动切换为图生图 / 参考图编辑。
  • 按张计费,单价由分辨率档位决定,见 模型价格。任务失败自动退款。

鉴权

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

请求参数

string
默认值:"gpt-image-2"
必填
模型 ID,填 gpt-image-2。其他变体以 模型广场 为准。
string
必填
图像描述,支持中英文。建议写清主体、场景、构图、风格和光线。
string
默认值:"1:1"
输出比例,或精确像素尺寸。支持 15 种比例: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。
string
默认值:"1k"
分辨率档位:1k、2k 或 4k,大小写均可。与比例形式的 size 一起决定实际像素,见下方对照表。
string[]
参考图列表,传入后为图生图 / 参考图编辑模式。

尺寸对照表

size 与 resolution 组合后的实际输出像素:
直接传像素尺寸时,计费档位按总像素数确定:不超过 1680×944 记为 1K,不超过 2560×2048 记为 2K,其余记为 4K。

提交响应

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

使用示例

文生图(最简请求)
4K 横版海报
图生图(参考图 URL)
多图融合(URL 与 Base64 混填)

查询结果

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