图片生成（统一接口 · 支持多模型）

图片生成 · 统一接口

通过 /v1/images/generations 端点，传入不同 model 参数调用不同图像生成模型。所有模型共用同一接口，参数透传兼容，只需更换 model 值。

🔗 接口参考文档：https://platform.openai.com/docs/api-reference/images/create

🛠 请求字段说明

model (string，必填)
模型名称。可选值：

2.5 系列：gpt-image-2.5-sunburst、gpt-image-2.5-sunburst-c、gpt-image-2.5-flare、gpt-image-2.5-flare-c

2 代：gpt-image-2、gpt-image-2-c

1.5 代：gpt-image-1.5

1 代：gpt-image-1

带 -c 后缀为逆向版本，参数完全一致，生成质量同级接近但略有下降。

prompt (string，必填)
画面描述文本，最高支持 32,000 字符。支持中英文双语描述，需在画面中渲染文字时建议在 Prompt 中用引号标注短语。

n (integer，可选)
生成张数，范围 1~10，默认 1。所有模型均支持。

size (string，可选)
图片尺寸，默认 1024x1024。不同模型支持的尺寸范围有差异：

2.5 系列：最高支持 3840×2160（4K 级），长边不超过 3840px，宽高须为 16 的倍数，宽高比范围 1:3 ~ 3:1，也可设为 auto 自适应。

gpt-image-2 / 2-c：支持 1024x1024、1536x1024（横版）、1024x1536（竖版）、自定义宽高（须为 16 的倍数）、auto。

gpt-image-1.5：支持 1024x1024、1536x1024、1024x1536，以及自定义宽高。

gpt-image-1：仅支持 1024x1024、1536x1024、1024x1536 三种固定尺寸。

quality (string，可选)
画质细节档位，默认 auto。不同代际支持的档位不同：

2.5 系列：auto、low（快速）、medium、high、xhigh（超精细）、max（极致精细，适合密集纹理与复杂构图）。

gpt-image-2 / 2-c / 1.5 / 1：auto、low、medium、high。

background (string，可选)
背景模式，默认 auto。所有模型均支持：

auto — 模型自行判断

opaque — 不透明纯色背景

transparent — 原生透明背景，免抠图（输出格式须为 png 或 webp）

output_format (string，可选)
输出格式，支持 png、webp、jpeg。若使用透明背景，必须指定为 png 或 webp。所有模型均支持。

output_compression (integer，可选)
图片压缩等级，范围 0~100，默认 100。仅在 webp 或 jpeg 格式下生效。所有模型均支持。

注：旧版字段名 compression 仍可透传兼容。

moderation (string，可选)
审核严格度，默认 auto。所有模型均支持：

auto — 标准审核

low — 宽松模式，降低误拦风险

safety_identifier (string，可选)
安全追踪标识，传入稳定的隐私安全用户哈希值（如邮箱哈希），用于面向终端用户应用的安全追踪。

仅 2.5 系列支持（含 -c 后缀版本），其余模型不支持此字段。

response_format (string，可选)
返回格式，支持 b64_json（推荐）或 url。所有模型均支持。

🔍 模型选择建议

极致画质、精细毛发/材质、画面内复杂文字渲染、商用设计 → gpt-image-2.5-sunburst

快速出图、批量原型、日常创作 → gpt-image-2.5-flare

上代旗舰（已验证工作流或不需要 2.5 新特性） → gpt-image-2

均衡画质与成本 → gpt-image-1.5

轻量快速、成本敏感 → gpt-image-1

高频低预算、对画质要求不极端 → 选择对应模型的 -c 后缀版本

✍️ 实用提示：

生成免抠图素材（图标、人物立绘、贴纸）：配置 "background": "transparent", "output_format": "png" 即可

-c 后缀版本与原版参数完全一致，只需替换 model 字段值

未来新图像模型上线时，只需更换 model 字段值即可，其余参数透传兼容

模型与官方文档

示例模型：gpt-image-2.5-sunburst

本站在架模型（图像）：gpt-image-2.5-sunburst、gpt-image-2、gpt-image-1、gpt-image-2.5-sunburst-c、gpt-image-2.5-flare、gpt-image-2.5-flare-c、gpt-image-1.5、gpt-image-2-c

厂商官网：OpenAI 模型文档

说明：模型名称需与【模型广场】完全一致；不同令牌分组可用的模型不同，以控制台展示为准。

curl --location 'https://4sapi.com/v1/images/generations' \ --header 'Accept: application/json' \ --header 'Authorization: Bearer sk-' \ --header 'Content-Type: application/json' \ --data '{ "model": "gpt-image-2.5-sunburst", "prompt": "一只纯白色暹罗猫坐在阳光照射的书架旁，写实风格，高清细节", "n": 1, "size": "1024x1024", "quality": "high", "background": "auto", "output_format": "png", "moderation": "auto" }'

{ "created": 1762427218, "background": "auto", "data": [ { "b64_json": "iVBORw0KGgoAAAANSUhEUgAABQAAAALQAQAAAADmbXm2AAAgAElEQVR4nOyd...", "generation_id": "gen-xxxx-xxxx-xxxx" } ], "output_format": "png", "quality": "high", "safety_identifier": "user-12345", "size": "1024x1024", "usage": { "input_tokens": 1573, "input_tokens_details": { "image_tokens": 1521, "text_tokens": 52 }, "output_tokens": 962, "output_tokens_details": { "image_tokens": 962, "text_tokens": 0 }, "total_tokens": 2535 } }

图片生成（统一接口 · 支持多模型）