图片生成（Image 2）

使用 OpenAI 兼容接口根据文本生成图片。gpt-image-2 返回 Base64 编码的图片，并在响应中提供实际尺寸、格式、质量和令牌用量。

接口

POST https://api.ezmodel.cloud/v1/images/generations
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

gpt-image-2 请求参数

参数	类型	必填	默认值	说明
model	string	是	-	使用 gpt-image-2
prompt	string	是	-	图片描述，最长 32,000 字符
n	integer	否	1	生成数量，范围 1–10
size	string	否	auto	auto、标准尺寸或合法的 宽x高 自定义尺寸
quality	string	否	auto	auto、low、medium、high
background	string	否	auto	auto 或 opaque；不支持透明背景
output_format	string	否	png	png 或 jpeg
output_compression	integer	否	100	JPEG 压缩质量，范围 0–100
moderation	string	否	auto	auto 或 low
user	string	否	-	终端用户标识

尺寸规则

• 标准尺寸：1024x1024、1536x1024、1024x1536。
• auto 由模型选择实际尺寸，响应中的 size 是最终尺寸。
• 自定义尺寸示例：1280x720、1536x864。宽和高都必须是 16 的倍数，宽高比需在 1:3 到 3:1 之间。
• 超过 2560x1440 的尺寸属于实验范围，最大为 3840x2160，并仍受模型像素和边长限制。

普通请求

curl https://api.ezmodel.cloud/v1/images/generations \
  -H "Authorization: Bearer $EZMODEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "雨后的香港街道，电影感夜景，霓虹灯倒影",
    "size": "1024x1024",
    "quality": "low",
    "output_format": "png",
    "n": 1
  }'

自定义横图与 JPEG

curl https://api.ezmodel.cloud/v1/images/generations \
  -H "Authorization: Bearer $EZMODEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "极简海边产品摄影，宽幅构图",
    "size": "1280x720",
    "quality": "medium",
    "output_format": "jpeg",
    "output_compression": 60,
    "n": 1
  }'

Python

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.ezmodel.cloud/v1",
)

response = client.images.generate(
    model="gpt-image-2",
    prompt="雨后的香港街道，电影感夜景，霓虹灯倒影",
    size="1024x1024",
    quality="low",
    n=1,
)

image_base64 = response.data[0].b64_json
print(image_base64[:80])

响应

gpt-image-2 的结果位于 data[].b64_json。请按响应中的 output_format 选择保存文件的扩展名。

{
  "created": 1710000000,
  "background": "opaque",
  "data": [
    {
      "b64_json": "iVBORw0KGgo..."
    }
  ],
  "output_format": "png",
  "quality": "low",
  "size": "1024x1024",
  "usage": {
    "input_tokens": 20,
    "input_tokens_details": {
      "image_tokens": 0,
      "text_tokens": 20
    },
    "output_tokens": 196,
    "output_tokens_details": {
      "image_tokens": 196,
      "text_tokens": 0
    },
    "total_tokens": 216
  }
}

需要基于现有图片生成新版本时，请使用图片编辑接口。