Skip to Content

GPT Image

OpenAI Images
文生图POST /v1/images/generations
图像编辑 / 参考图生成POST /v1/images/edits

gpt-image-2 默认返回 base64,图片内容在 data[0].b64_json。

平台限制:n 仅支持省略或传 1,文生图和图像编辑均返回单张图片。

端点选择

场景接口请求格式输入图片字段
文生图POST /v1/images/generationsapplication/json不需要
本地图片编辑 / 多参考图POST /v1/images/editsmultipart/form-dataimage 或多个 image[]
公网 URL / data URL 编辑POST /v1/images/editsapplication/jsonimages[].image_url
局部重绘POST /v1/images/editsmultipart/form-dataimage + 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