GPT Image 2

GPT Image 2 兼容 OpenAI 图片接口格式，适合已经使用 OpenAI SDK 或 /v1/images/* 路径的项目。

接口选择

需要同步返回 base64 或 URL 时使用本页接口。需要提交后轮询、批量生成或后台处理时，使用异步图片任务。

接口概览

能力	方法	路径	请求格式
图片生成	`POST`	`/v1/images/generations`	`application/json`
图片编辑	`POST`	`/v1/images/edits`	`multipart/form-data`

所有请求都使用：

Authorization: Bearer $API_KEY

图片生成

请求体

参数	类型	必填	说明
`model`	string	是	固定使用 `gpt-image-2`
`prompt`	string	是	图片描述
`n`	integer	否	生成数量，默认 `1`
`size`	string	否	`auto` 或分辨率，例如 `1024x1024`
`quality`	string	否	`low`、`medium`、`high`、`auto`
`response_format`	string	否	`b64_json` 或 `url`

curl https://cdn.12ai.org/v1/images/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一张干净的 SaaS 产品宣传图，浅色背景，真实设备展示",
    "size": "1536x1024",
    "quality": "high",
    "response_format": "url"
  }'

图片编辑

请求参数

参数	类型	必填	说明
`model`	string	是	固定使用 `gpt-image-2`
`prompt`	string	是	编辑说明
`image`	file	是	参考图；多张图重复传 `image` 字段
`mask`	file	否	遮罩图，需要 alpha 通道
`n`	integer	否	输出数量，默认 `1`
`size`	string	否	`auto` 或分辨率
`quality`	string	否	`low`、`medium`、`high`、`auto`
`response_format`	string	否	`b64_json` 或 `url`

curl https://cdn.12ai.org/v1/images/edits \
  -H "Authorization: Bearer $API_KEY" \
  -F "model=gpt-image-2" \
  -F "prompt=保留主体，把背景改成明亮的现代办公室" \
  -F "image=@input.png" \
  -F "size=1024x1024" \
  -F "quality=high" \
  -F "response_format=url"

遮罩要求

mask 需要与第一张编辑图尺寸一致，并包含 alpha 通道。多张参考图时，遮罩只应用于第一张图。

size 参数

size 支持 auto（默认，由模型决定）或自定义分辨率。自定义分辨率需要满足：最大边长不超过 3840px，两边均为 16px 的倍数，长短边比例不超过 3:1，总像素在 655,360 到 8,294,400 之间。

推荐使用以下分辨率，其他分辨率可能耗时更长，甚至超时：

比例	1K	2K	4K
`1:1`	`1254x1254`	`2048x2048`	`2880x2880`
`5:4`	`1402x1122`	`2240x1792`	`3200x2560`
`4:3`	`1448x1086`	`2304x1728`	`3264x2448`
`3:2`	`1536x1024`	`2496x1664`	`3504x2336`
`16:9`	`1672x941`	`2560x1440`	`3840x2160`
`21:9`	`1915x821`	`3024x1296`	`3696x1584`
`4:5`	`1122x1402`	`1792x2240`	`2560x3200`
`3:4`	`1086x1448`	`1728x2304`	`2448x3264`
`2:3`	`1024x1536`	`1664x2496`	`2336x3504`
`9:16`	`941x1672`	`1440x2560`	`2160x3840`

响应格式

response_format=b64_json 时返回 base64：

{
  "created": 1760000000,
  "data": [
    {
      "b64_json": "<BASE64_IMAGE_DATA>",
      "revised_prompt": "优化后的提示词"
    }
  ]
}

response_format=url 时返回图片 URL：

{
  "created": 1760000000,
  "data": [
    {
      "url": "https://img.example.com/images/example.png",
      "revised_prompt": "优化后的提示词"
    }
  ]
}

Python 示例

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxx",
    base_url="https://cdn.12ai.org/v1",
)

result = client.images.generate(
    model="gpt-image-2",
    prompt="一张干净的 SaaS 产品宣传图，浅色背景，真实设备展示",
    size="1536x1024",
    quality="high",
    response_format="url",
)

print(result.data[0].url)

常见错误

状态码	说明
`400`	请求参数错误，常见于 `size`、`quality` 或文件格式不正确
`401`	API Key 缺失或无效
`402`	余额不足
`403`	内容安全策略拦截
`429`	请求频率过高
`502`	上游服务异常，可稍后重试

On this page