POST/v1/images/generations

GPT Image 参数与模型限制

按具体模型选择质量、尺寸、图片编码和输入方式，避免把 DALL·E 参数、不同版本的档位或不同协议的字段混在一起。

API Key application/json

模型与合法组合

下列是已核对过的官方契约型号。它们使用本目录的生成、编辑、蒙版和流式流程；本站另有别名或按次模型时，必须以模型列表返回的完整 ID 为准。

模型 ID	质量与输出限制
`gpt-image-2.5-sunburst`	quality：auto / low / medium / high / xhigh / max。支持自定义尺寸；透明背景可用。
`gpt-image-2.5-flare`	quality：auto / low / medium / high / xhigh / max。支持自定义尺寸；透明背景可用。
`gpt-image-2`	quality：auto / low / medium / high。支持自定义尺寸；透明背景处于预览阶段。
`gpt-image-1.5`	quality：auto / low / medium / high。使用标准尺寸；透明背景可用。
`gpt-image-1`	quality：auto / low / medium / high。使用标准尺寸；透明背景可用。

本站当前可见型号（2026-10-02）

下面是青云TOP API 公共目录快照，不等同于厂商官方型号清单。带 -c、-preview、-t 或尺寸后缀的名称按本站模型 ID 使用；是否可调用仍以你的 API Key 的 GET /v1/models 结果为准。

模型 ID	可见协议	分组
`gpt-image-1`	image-generation、openai	OpenAI官转
`gpt-image-1.5`	image-generation、openai	OpenAI官转
`gpt-image-2`	image-generation、openai	AZ渠道OpenAI、OpenAI官转
`gpt-image-2-c`	image-generation、gemini、openai	按次计费
`gpt-image-2.5-flare`	image-generation、openai	OpenAI官转、AZ渠道OpenAI
`gpt-image-2.5-flare-c`	image-generation、openai	按次计费
`gpt-image-2.5-sunburst`	image-generation、openai	OpenAI官转、AZ渠道OpenAI
`gpt-image-2.5-sunburst-c`	image-generation、openai	按次计费

所有模型的生成入口和编辑入口相同。下表字段都是 Images 请求字段，不放到 metadata、parameters 或 tools 中。model 请始终明确填写，避免依赖其他接口的默认模型。

生成参数

POST https://top.qingyuntop.ai/v1/images/generations，使用 JSON 和 Bearer API Key。完整鉴权和三语言调用见文生图。

字段、类型与位置	填写规则与限制
`prompt`；string；JSON 顶层	必填；未指定默认值。必填，最多 32000 字符；描述主体、构图、文字与约束。编辑时说明修改目标和应保留内容。
`model`；string；JSON 顶层	必填；明确填写。本站调用请明确填写模型 ID；见模型表。不要省略，也不要填写不带 sunburst/flare 的 gpt-image-2.5。
`n`；integer；JSON 顶层	可选；默认 1。1–10 的整数；指输出图片数量，与输入素材数量不同。推荐先用 1。不要填写 0、小数或把通用上限当成模型上限。
`quality`；string；JSON 顶层	可选；默认 auto。1/1.5/2 使用 auto、low、medium、high；2.5 的两个型号还支持 xhigh、max。不要使用 DALL·E 的 hd 或 standard。
`output_format`；string；JSON 顶层	可选；默认 png。png、jpeg、webp；控制图片文件编码。字段名不是 format；与 Base64 返回方式不是同一概念。
`output_compression`；integer；JSON 顶层	可选；默认 100。0–100 的整数，仅用于 jpeg/webp；通常省略为 100。PNG 不发送此参数；它不改变像素尺寸。
`stream`；boolean；JSON 顶层	可选；默认 false。false 返回完整 JSON；true 返回 SSE 事件。流式编辑仍使用相同的 edits 地址。
`partial_images`；integer；JSON 顶层	可选；默认 0。0–3 的整数，配合 stream=true；0 不请求中间预览，默认 0。最终结果可能提前完成，实际预览数可少于请求数。
`size`；string；JSON 顶层	可选；默认 auto。尺寸字符串使用半角 x；常用 1024x1024、1536x1024、1024x1536。2/2.5 的自定义尺寸规则见下文；示例均显式设置尺寸。
`moderation`；string；JSON 顶层	可选；默认 auto。auto 或 low；控制内容审核强度，low 不表示取消内容规则。multipart 编辑的官方请求表未列此字段，本目录仅在 JSON 请求中介绍。
`background`；string；JSON 顶层	可选；默认 auto。auto、opaque、transparent。transparent 必须配合 png/webp；2 的透明背景处于预览阶段，2.5 支持透明背景。
`user`；string；JSON 顶层	可选；未指定默认值。可选的终端用户标识。使用应用内部的匿名稳定 ID，不发送邮箱、真实姓名或其他不必要的个人信息。

尺寸与分辨率

1 和 1.5 推荐使用 1024x1024、1536x1024、1024x1536，或让支持自动尺寸的模型使用 auto。不要把 DALL·E 的 1792x1024 直接套用于这些模型。

2 和 2.5 支持 WIDTHxHEIGHT 自定义尺寸，宽和高都必须是 16 的倍数，宽高比在 1:3 至 3:1 之间。1536x864 是合法的常用横图示例。高于 2560x1440 的分辨率属于实验范围，官方给出的最高分辨率是 3840x2160，还需要满足具体模型的像素总量与边长限制；不是任意两个小于该数值的边长都能组合。需要大图时逐档提高，不把实验分辨率当成稳定承诺。

尺寸中的分隔符是半角字母 x，不是乘号 ×，也不是 *。分辨率与 quality 是两个独立维度：前者影响像素尺寸，后者控制输出质量档位。

编辑输入与字段位置

文件表单使用 image 或重复的 image[] 上传文件。JSON 使用 images 数组，每项为包含 image_url 的对象，接受公开图片 URL 或带媒体类型前缀的 Base64 Data URL。二者不能只更改 Content-Type 就互相转换。

每次 1–16 张输入图片，PNG、JPEG 或 WebP，每张小于 50 MB；总请求可能受到更小的上传限制。Base64 编码约增加三分之一体积，JSON 图片引用还受字符串长度限制（最多 20971520 字符）。大文件优先使用本地上传。输入图片数量由素材数组或文件列表决定，n 决定输出图片数量。

蒙版为带透明通道的 PNG，小于 4 MB，与第一张输入图片同尺寸；完全透明的区域表示需要修改。input_fidelity 是保留输入特征的强度，quality 是输出质量，二者不要混淆。JSON 编辑详见对应参数表，蒙版详见局部编辑。

透明背景、压缩和旧参数

透明背景使用 background=transparent，并设置 output_format=png 或 webp。JPEG 不支持透明通道。
2 的透明背景处于预览阶段；2.5 两个型号支持透明背景。可先选 2.5 配合 quality=high 或 xhigh 进行比较。
output_compression 仅用于 JPEG/WebP，范围 0–100，通常省略为 100。PNG 请求不填写此参数。
删除旧示例中的 format；使用 output_format。删除 response_format 和 DALL·E 专用 style，风格要求写入 prompt。
stream=true 时，partial_images 可为 0–3；预览数量不是百分比进度或最终图片数量。

默认值与适用范围

生成接口的官方尺寸默认值为 auto；multipart 编辑表列出 1024x1024，JSON 编辑表列出 auto。本目录均显式填写 size、quality、n 和 output_format，使换模型或换输入方式时保持可预期。

response_format=url 属于其他图像模型的返回控制，不是 GPT Image 的下载开关。需要结果落盘时解码 b64_json，见结果保存。

官方参考：OpenAI Images API 定义。

Images API 兼容协议

调用与返回说明

使用青云TOP API 的 Images 兼容入口生成或编辑图片。它复用 OpenAI Images 的请求形状，但页面中的厂商型号、别名和能力仍需按本站当前模型目录核对。

请求时注意

请求头使用 Authorization: Bearer YOUR_API_KEY 和页面声明的 Content-Type。路径中的厂商名称不改变青云TOP API 的鉴权方式，也不要求客户端携带厂商密钥。
模型 ID、模型版本和后缀必须使用当前账号 GET /v1/models 返回且与本页协议匹配的值；旧示例中的固定型号不能视为永久可用。
生成接口通常将 prompt、model、size/比例和输出格式放在 JSON Body；编辑接口还要按 schema 传入 image、mask 或多图素材。不要把 multipart 字段拼进 JSON。
如果请求包含图片 URL、Base64 或文件，先核对页面中的媒体类型、大小和数组顺序；上游支持某种素材不代表本站所有渠道都开放。

返回时注意

同步图片响应通常在 data、output 或等价字段中返回 URL、Base64 或图片对象；先检查 HTTP 状态和错误字段，再按返回格式保存结果。
URL 可能有有效期，Base64 需要按响应中的格式解码。不要把示例 URL 当作永久存储地址，也不要把 Markdown 预览当作二进制文件。

Request

请求

/v1/images/generations

Body

必填

Bodyobject

promptstring必填

所需图像的文本描述。最大长度为 1000 个字符。

ninteger必填

要生成的图像数。必须介于 1 和 10 之间。

sizestring必填

生成图像的尺寸。对于 GPT 图像模型，必须是 1024x1024 、 1536x1024 （横版）、 1024x1536 （竖版）或 auto （默认值）之一，对于 dall-e-2 必须是 256x256 、 512x512 或 1024x1024 之一，对于 dall-e-3 必须是 1024x1024 、 1792x1024 或 1024x1792 之一。

路径、查询与 Header 参数

参数	位置	类型	必填	说明	示例
`Content-Type`	Header	string	是	-	application/json
`Accept`	Header	string	是	-	application/json
`Authorization`	Header	string	是	必填。使用青云TOP API 的 API Key，保留 Bearer 后的空格。	Bearer YOUR_API_KEY

请求示例application/json

curl -X POST https://top.qingyuntop.ai/v1/images/generations \
  -H "Authorization: Bearer ${QINGYUN_TOP_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
  "size": "1024x1536",
  "prompt": "a man walks",
  "model": "gpt-image-1.5",
  "n": 1
}'

Response

返回响应 `200`

HTTP 响应

响应 200object

idstring必填

objectstring必填

createdinteger必填

choicesarray<object>必填

元素object

indexinteger

messageobject

rolestring必填

contentstring必填

finish_reasonstring

usageobject必填

prompt_tokensinteger必填

completion_tokensinteger必填

total_tokensinteger必填

响应示例json

{
  "id": "chatcmpl-123",
  "object": "chat.completion",
  "created": 1677652288,
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "\n\nHello there, how may I assist you today?"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 9,
    "completion_tokens": 12,
    "total_tokens": 21
  }
}

Images API 兼容协议

调用与返回说明

使用青云TOP API 的 Images 兼容入口生成或编辑图片。它复用 OpenAI Images 的请求形状，但页面中的厂商型号、别名和能力仍需按本站当前模型目录核对。

请求时注意

请求头使用 Authorization: Bearer YOUR_API_KEY 和页面声明的 Content-Type。路径中的厂商名称不改变青云TOP API 的鉴权方式，也不要求客户端携带厂商密钥。
模型 ID、模型版本和后缀必须使用当前账号 GET /v1/models 返回且与本页协议匹配的值；旧示例中的固定型号不能视为永久可用。
生成接口通常将 prompt、model、size/比例和输出格式放在 JSON Body；编辑接口还要按 schema 传入 image、mask 或多图素材。不要把 multipart 字段拼进 JSON。
如果请求包含图片 URL、Base64 或文件，先核对页面中的媒体类型、大小和数组顺序；上游支持某种素材不代表本站所有渠道都开放。

返回时注意

同步图片响应通常在 data、output 或等价字段中返回 URL、Base64 或图片对象；先检查 HTTP 状态和错误字段，再按返回格式保存结果。
URL 可能有有效期，Base64 需要按响应中的格式解码。不要把示例 URL 当作永久存储地址，也不要把 Markdown 预览当作二进制文件。

GPT Image 参数与模型限制

模型与合法组合

本站当前可见型号（2026-10-02）

生成参数

尺寸与分辨率

编辑输入与字段位置

透明背景、压缩和旧参数

默认值与适用范围

调用与返回说明

请求时注意

返回时注意

请求

Body

路径、查询与 Header 参数

返回响应 200

调用与返回说明

请求时注意

返回时注意

返回响应 `200`