返回模型调用 API 参考POST/v1/images/generations
Qwen 编辑与 GPT Image 的区别
原 qwen-image-edit-2509 链接保留为迁移说明；Qwen 图片编辑属于独立模型系列，不使用 GPT Image 的型号与参数规则。
适用范围
qwen-image-edit-2509 不是 GPT Image 型号。本目录所列的 GPT Image 2.5、2、1.5 和 1 的图像质量、输入张数、蒙版和透明背景规则，不能直接作为 Qwen 的能力说明。
不同模型可以共享 /v1/images/edits 这样的兼容路径，但请求体仍可能不同。不要把 Qwen 的 input.messages 或 parameters 结构复制到本目录的 GPT Image JSON 编辑中；GPT Image 使用顶层 prompt、model 和 images。
选择下一步
若希望调用 GPT Image，请使用JSON 图片编辑或本地图片上传，并从模型表选择完整 ID。
若希望继续调用 Qwen，请在“绘画模型 → 千问Qwen 系列”查找对应版本，核对当前可用型号、素材字段和输出方式；没有对应调用说明时联系本站支持确认。本页保留原链接，不据旧页面标题承诺该历史型号当前可用，也不附未确认的 Qwen 请求样例。
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/generationsBody
必填路径、查询与 Header 参数
| 参数 | 位置 | 类型 | 必填 | 说明 | 示例 |
|---|
Authorization | Header | string | 是 | 必填。使用青云TOP API 的 API Key，保留 Bearer 后的空格。 | Bearer YOUR_API_KEY |
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 预览当作二进制文件。
