GPT Image 2

gpt-image-2 使用标准 OpenAI Images 接口，支持文生图和参考图编辑。本文只描述对外请求和返回标准。

接口

场景	方法	路径	请求格式
文本生成图片	POST	/v1/images/generations	application/json
参考图编辑 / 图生图	POST	/v1/images/edits	multipart/form-data

请求参数

参数	必填	说明
model	是	固定为 gpt-image-2
prompt	是	图像描述文本
size	否	输出尺寸，格式为 WIDTHxHEIGHT，例如 1024x1024、1536x1024、1024x1536、2560x1440、3840x2160
n	否	生成图片数量，默认 1
quality	否	可选 auto、low、medium、high；不传时使用模型默认
response_format	否	可选 url 或 b64_json；不传时使用平台默认
user	否	终端用户标识

/v1/images/edits 还必须上传参考图文件，文件字段名固定为 image。请求参数以本页表格为准。

尺寸规则

• size 使用 WIDTHxHEIGHT，宽高必须是 16 的倍数。
• 宽高比例必须在 1:3 到 3:1 之间。
• 最高可使用到 3840x2160 同等级尺寸；超过 2560x1440 属于高分辨率/实验性尺寸，建议先小批量测试。
• gpt-image-2 的标准 OpenAI Images 接口不使用 resolution、aspect_ratio、image_size 作为公开请求参数。

常用尺寸示例：

目标	size 示例
1:1 标准	1024x1024
4:3 标准	1024x768
3:4 标准	768x1024
16:9 2K	2560x1440
9:16 2K	1440x2560
16:9 4K	3840x2160
9:16 4K	2160x3840

文生图示例

curl -X POST https://cubicspaces.cloud/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "Generate a clean product photo of a red ceramic mug on a white tabletop",
    "size": "1024x768",
    "n": 1,
    "quality": "auto",
    "response_format": "b64_json"
  }'

参考图编辑示例

curl -X POST https://cubicspaces.cloud/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=gpt-image-2" \
  -F "prompt=根据参考图生成一张干净的产品摄影图" \
  -F "image=@reference.png" \
  -F "size=1024x768" \
  -F "n=1" \
  -F "quality=auto" \
  -F "response_format=b64_json"

返回结构

{
  "created": 1778218450,
  "data": [
    {
      "b64_json": "iVBORw0KGgo...",
      "revised_prompt": "A clean product photo..."
    }
  ]
}

如果请求 response_format=url 且当前模型支持，data[0] 中会返回 url 字段。图片结果统一从 data[0].b64_json 或 data[0].url 读取。