两种官方协议不要混用
| 协议 | 典型请求 | 编辑图片位置 | 尺寸写法 |
|---|---|---|---|
| Qwen Image 3.0 OpenAI 兼容 | POST /compatible-mode/v1/images/generations | 顶层 image 字符串或数组 | 1024x1024 |
| DashScope 原生同步 | POST /api/v1/services/aigc/multimodal-generation/generation | input.messages[].content[] 中的 image | 1024*1024 |
Qwen Image 3.0 的官方兼容协议将生成与编辑都放在 /images/generations，不使用 /images/edits、multipart 或 mask。它是同步、非流式接口，不提供 partial image；response_format=b64_json 会被忽略，仍返回 URL。厂商 DashScope 另有异步调用，但本站当前没有在本目录确认相应创建、查询或下载入口。
青云TOP API 的统一图片路径 /v1/images/generations 是通用入口；路径存在并不能证明任意千问型号已可用。当前请先按接入状态页查询型号。不要将原生 input、parameters 与兼容顶层参数混写，也不要因为都使用 Images 命名就套用其他模型的编辑格式。
常见错误
模型不存在或无权限
先调用 GET /v1/models，确认模型 ID 与大小写完全一致。若没有目标型号，检查 API Key 分组权限后联系支持；不要把阿里云 API Key 放进青云TOP请求。
size 被拒绝
Qwen Image 3.0 官方兼容协议使用字母 x，例如 1024x1024；DashScope 原生协议使用 *。两者都不要写成排版乘号 ×。检查协议、总像素与宽高比是否同时满足限制；不要将此表当作尚未确认的本站型号参数。
图片编辑没有生效
Qwen Image 3.0 官方兼容协议要求把图片放在顶层 image；DashScope 要把图片和文字放进 input.messages。两种结构不可互换。请先确认完整模型 ID 和对应协议，不要沿用历史 qwen-image-edit-2509 请求来推断新型号行为；当前资料未为这个历史 ID 确认本站调用格式。
只收到 URL 或下载失败
图片 URL 是临时结果，收到成功响应后立即下载并保存。记录响应中的 URL、请求时间和脱敏错误；不要把临时 URL 当作永久图片地址，也不要因为下载失败就盲目重复生成。
如何反馈问题
请提供模型 ID、请求路径、HTTP 状态、响应中的 x-request-id（如有）和脱敏请求体。不要提交 API Key、上游凭据或完整图片 Base64。若请求超时或连接中断，不能据此判断图片未生成；先保存响应和时间联系支持确认，避免立即重复提交。
当前可用的其他生图文档
需要立即接入生图功能时，可从Gemini Image、豆包 Seedream或Grok Image开始；每个系列的字段和模型权限分别以对应文档为准。
官方参考：Qwen Image 3.0 API。