POST/v1/images/generations

GPT Image 接入概览与模型选择

使用青云TOP API 调用 GPT Image 2.5、2、1.5 和 1，完成文字生成图片、参考图编辑、蒙版局部修改和流式输出。

API Key application/json

使用青云TOP API 调用 GPT Image 2.5、2、1.5 和 1，完成文字生成图片、参考图编辑、蒙版局部修改和流式输出。模型可用性以当前 API Key 的 GET /v1/models 为准。

功能与接入方式

本目录推荐使用 Images 格式。文生图向 POST /v1/images/generations 发送 JSON；编辑向 POST /v1/images/edits 发送文件表单或 JSON 图片引用。普通请求在同一次响应中返回图片，流式请求通过 SSE 返回预览和最终图片；不需要创建视频任务或轮询视频接口。

你的需求	阅读入口
从文字生成海报、插画或产品概念图	文生图
上传一张或多张图片后修改、融合参考风格	图片编辑与多图输入
使用公开 URL 或 Base64 Data URL 编辑	JSON 图片编辑
指定图片中的局部区域进行修改	蒙版局部编辑
逐步接收预览与最终图片	流式生成与编辑
解码、保存图片或处理空结果	返回结果与图片保存

GPT Image 2.5 与 GPT Image 2

GPT Image 2.5 包含两个独立官方模型 ID：gpt-image-2.5-sunburst 和 gpt-image-2.5-flare，不能写成裸的 gpt-image-2.5。两者使用同一套 Images 生成与编辑结构，质量档位包含 auto、low、medium、high、xhigh、max。gpt-image-2 使用相同入口，质量档位先按 auto、low、medium、high 选择；不要把 2.5 的 xhigh 或 max 直接发给 2。

当前公开目录型号（2026-10-30）

下表来自青云TOP API 当前公开 pricing 目录。-c 是本站或渠道的独立路由别名，不是 OpenAI 官方标准模型 ID；实际请求必须使用当前 API Key 的 GET /v1/models 返回值。

模型 ID	目录协议与分组	说明
`gpt-image-2`	image-generation、openai；AZ渠道OpenAI、OpenAI官转、Codex	GPT Image 2，支持生成与编辑
`gpt-image-2-c`	image-generation、openai、openai-response 等；按次计费	本站/渠道别名，具体映射以渠道为准
`gpt-image-2.5-flare`	image-generation、openai、image-edit；AZ渠道OpenAI、OpenAI官转	官方 Flare，快速高质量日常生图与编辑
`gpt-image-2.5-flare-c`	image-generation、openai、openai-response 等；按次计费	Flare 的本站/渠道别名
`gpt-image-2.5-sunburst`	image-generation、openai、image-edit；AZ渠道OpenAI、OpenAI官转	官方 Sunburst，偏高保真生成与精细编辑
`gpt-image-2.5-sunburst-c`	image-generation、openai、openai-response 等；按次计费	Sunburst 的本站/渠道别名
`gpt-image-1.5`	image-generation、openai；OpenAI官转	GPT Image 1.5 兼容入口
`gpt-image-1`	image-generation、openai；OpenAI官转	GPT Image 1 兼容入口

目录快照不是账号权限清单。模型、渠道、分组或余额变化时，先刷新 GET /v1/models；不要把其他账号的完整列表写死。

参考图与编辑边界

文生图不上传参考图；需要保留主体、风格或构图时使用编辑接口。编辑输入为 1–16 张 PNG、JPEG 或 WebP，每张小于 50 MB；JSON 编辑使用 images 数组，multipart 使用重复的 image[] 文件字段，顺序就是参考图顺序。n 表示输出图片数量，不表示输入参考图数量。蒙版使用与第一张输入图同尺寸的透明 PNG，文件小于 4 MB，透明区域为待修改部分。具体模型和渠道可能进一步收窄限制，以上限值不能替代对应页面的 schema。

鉴权与调用

请求头使用 Authorization: Bearer YOUR_API_KEY，基础地址为 https://top.qingyuntop.ai。第一次接入建议从文生图示例开始，明确填写模型、n=1、size、quality 和 output_format。返回图片主要读取 data[].b64_json；output_format 选择 PNG/JPEG/WebP 编码，GPT Image 不需要填写 response_format。

协议与迁移

GPT Image 的型号差异在参数、生成、编辑、蒙版和流式页面中说明。Responses 的图像生成工具需要分别选择对话模型和图像工具模型，不能直接照搬 Images 请求；参见 Responses 图像工具说明。

参考

OpenAI 模型目录 · OpenAI 图像生成指南 · 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

string必填

模型名

promptstring必填

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

sizestring

图片尺寸 1024x1024 正方形 1536x1024 横版 1024x1536 竖版 2048x2048 2K正方形 2048x1152 2K横版 3840x2160 4K横版 2160x3840 4K竖版 auto 默认尺寸严格限制规则 1. 图片最大边长 ≤ 3840px 2. 宽高两边像素均为 16px 的倍数 3. 长边 / 短边比值 ≤ 3:1 4. 总像素范围：最小 655360 ~ 最大 8294400

formatstring

图片格式可选：png 、 jpeg 、 webp

qualitystring

图片画质可选：low 、 medium 、 high 、 auto（默认）

ninteger必填

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

路径、查询与 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 '{
  "model": "gpt-image-2",
  "prompt": "A childrens book drawing of a veterinarian using a stethoscope to listen to the heartbeat of a baby otter.",
  "n": 1,
  "size": "1024x1024",
  "quality": "low",
  "format": "jpeg"
}'

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 接入概览与模型选择

功能与接入方式

GPT Image 2.5 与 GPT Image 2

当前公开目录型号（2026-10-30）

参考图与编辑边界

鉴权与调用

协议与迁移

参考

调用与返回说明

请求时注意

返回时注意

请求

Body

路径、查询与 Header 参数

返回响应 200

调用与返回说明

请求时注意

返回时注意

返回响应 `200`