GPT Image
gpt-image-2 默认返回 base64,图片内容在 data[0].b64_json。
平台限制:
n 仅支持省略或传 1,文生图和图像编辑均返回单张图片。端点选择
| 场景 | 接口 | 请求格式 | 输入图片字段 |
|---|---|---|---|
| 文生图 | POST /v1/images/generations | application/json | 不需要 |
| 本地图片编辑 / 多参考图 | POST /v1/images/edits | multipart/form-data | image 或多个 image[] |
| 公网 URL / data URL 编辑 | POST /v1/images/edits | application/json | images[].image_url |
| 局部重绘 | POST /v1/images/edits | multipart/form-data | image + mask |
调用示例
文生图
curl "https://api.example.com/v1/images/generations" \
-H "Authorization: Bearer <YOUR_API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "生成一张电商主图:白底、极简构图、一只红色陶瓷马克杯,柔和自然光,产品边缘清晰",
"n": 1,
"size": "1536x1024",
"quality": "high",
"output_format": "png"
}'返回说明:生成和编辑的返回结构一致。GPT 图片模型默认返回
data[0].b64_json,前端可拼成 data:image/png;base64,… 预览,后端可 base64 解码后保存为文件。常用参数
| 参数 | 适用接口 | 说明 |
|---|---|---|
prompt | 生成 / 编辑 | 必填。描述目标图片,编辑场景要明确哪些元素保持不变、哪些元素需要替换。 |
n | 生成 / 编辑 | 仅支持省略或传 1。 |
size | 生成 / 编辑 | 常用 1024x1024、1536x1024、1024x1536、auto。gpt-image-2 也支持 WIDTHxHEIGHT,宽高需为 16 的倍数,宽高比建议保持在 1:3 到 3:1。 |
quality | 生成 / 编辑 | 可传 low、medium、high、auto。质量越高通常耗时和成本越高。 |
output_format | 生成 / 编辑 | 可传 png、jpeg、webp。使用 jpeg / webp 时可额外传 output_compression。 |
image / image[] | 编辑 | multipart 上传本地文件。单图可用 image,多图用多个 image[] 字段。 |
images | 编辑 | JSON 方式输入图片引用,元素形如 {“image_url”: “https://…”} 或 data URL。 |
input_fidelity | 编辑 | 可传 high 或 low。需要尽量保留参考图人物、产品、构图时传 high。 |
mask | 编辑 | 局部重绘用。遮罩图需和原图尺寸一致,并带透明通道。 |
- 本地图片编辑使用
multipart/form-data,公网 URL 或 data URL 编辑可使用 JSON。 - 多参考图使用多个
image[]字段,或在 JSON 中传入多个images元素。 - 图片 base64 体积较大,建议将 HTTP 超时时间设置为 180 秒或更高。
Last updated on