GPT-Image-2
GPT-Image-2 官方渠道 图像编辑
基于参考图进行图像编辑 / 图生图 / 局部重绘(mask inpainting),使用 gpt-image-2 模型
POST
- 与图像生成使用同一端点
/v1/images/generations - 请求中包含
image_urls即自动切换为编辑模式 - 支持多参考图融合(最多 16 张)、局部重绘(mask)
- 参考图须为公网可访问的 PNG / JPG,单张 ≤ 50MB
编辑模式的调用方式与生成完全兼容:只需在生成请求基础上加入
image_urls(和可选的 mask_url)即可,无需切换端点。Authorizations
string
必填
Body
string
默认值:"gpt-image-2"
必填
固定填写
gpt-image-2string
必填
描述期望的编辑效果示例:
"把背景换成星空,保持主体人物不变"string
遮罩图 URL,用于局部重绘(inpainting)
- 须为 PNG 格式,且包含 Alpha 通道
- 透明区域(alpha = 0)为待重绘区域,不透明区域保持原样
- 尺寸须与第一张参考图一致
string
默认值:"1:1"
输出图像宽高比支持 13 种比例,也可传
auto: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:21string
默认值:"1k"
分辨率档位:
1k / 2k / 4k1K / 2K 支持全部 13 个比例;4K 仅支持 6 个比例(16:9 / 9:16 / 2:1 / 1:2 / 21:9 / 9:21)string
默认值:"high"
图片质量:
low / medium / highinteger
默认值:1
生成数量,范围
1 ~ 10string
默认值:"png"
输出格式:
png / jpegAzure OpenAI 不支持
webp 格式。integer
默认值:100
JPEG 压缩强度,范围
0–100(仅对 output_format: "jpeg" 有效)Response
string
任务唯一标识符,用于查询任务状态
string
固定为
generation.taskstring
任务状态:
queued / in_progress / completed / failedinteger
任务进度百分比(0-100)
integer
任务创建时间戳(Unix 时间戳)