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

图片生成 · 统一接口

通过 /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-flare

2 代：gpt-image-2

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-flare、gpt-image-1.5

厂商官网：OpenAI 模型文档

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

请求参数

Header 参数

Body 参数application/json

示例

{
    "model": "gpt-image-2.5-sunburst",
    "prompt": "一只纯白色暹罗猫坐在阳光照射的书架旁，写实风格，高清细节",
    "n": 1,
    "size": "1024x1024",
    "quality": "high",
    "background": "auto",
    "output_format": "png",
    "moderation": "auto"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "created": 0,
    "background": "string",
    "data": [
        {
            "b64_json": "string",
            "generation_id": "string"
        }
    ],
    "output_format": "string",
    "quality": "string",
    "safety_identifier": "string",
    "size": "string",
    "usage": {
        "input_tokens": 0,
        "input_tokens_details": {
            "image_tokens": 0,
            "text_tokens": 0
        },
        "output_tokens": 0,
        "output_tokens_details": {
            "image_tokens": 0,
            "text_tokens": 0
        },
        "total_tokens": 0
    }
}

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