Qwen Image 3.0
Qwen Image 3.0 图像生成
- 异步处理模式,返回任务 ID 用于后续查询
- 支持文生图、图生图(1-3 张参考图编辑)
- 支持 1K / 2K 分辨率,单次最多 6 张
- 提供标准版与 Pro 版(密集排版、图文更强)
POST
支持的模型
Authorizations
string
必填
Body
string
必填
模型名称
qwen-image-3.0- 标准版qwen-image-3.0-pro- Pro 版(密集图文 / 排版)
string
必填
图像生成的文本描述,最长约 4.5k token
string[]
参考图 URL 数组(图生图 / 图像编辑),1-3 张
- 支持公网
http(s)://URL,或data:image/png;base64,...(base64 会先转存) - 格式:JPG / JPEG / PNG / BMP / TIFF / WEBP / GIF
- 单张 ≤ 10MB,宽高建议 384-2048 像素
string
默认值:"1K"
分辨率档位(与计费档位相关)
1K(默认,兼容小写)2K
size 中直接写像素(如 1600x900)。直接给像素时,面积 > 225 万像素 按 2K 档计费。string
默认值:"1:1"
图像宽高比,或直接像素尺寸支持的宽高比:
1:1(默认)4:3/3:416:9/9:163:2/2:3
16x9 写法,或像素如 1024x1024。自定义像素时,宽与高各自须在 512 ~ 2048,宽高比 1:8 ~ 8:1。不传 size 也不传 resolution 时固定出 1024×1024。integer
默认值:"1"
出图张数,1-6。超过 6 会自动截断为 6。
string
反向提示词,描述不希望出现的内容
boolean
默认值:"false"
提示词智能改写默认关闭,以保证结果可预测。需要智能改写时设为
true。string
改写方式(仅 3.0 系列,且需
prompt_extend: true)direct- 文生图 / 图生图均可agent- 仅文生图,改写更激进
尺寸对照表
通过resolution(档位)+ size(比例)组合控制输出尺寸:
使用场景示例
文生图(多张)
文生图(密集排版,开改写)
图生图(图像编辑)
带反向提示词
限制
Response
integer
响应状态码,成功时为 200
array
返回数据数组
与 2.0 的差异
注意事项
- 异步处理:提交后返回
task_id,使用 获取任务状态 轮询;建议每 3~5 秒一次,超时约 3 分钟(2K + 多张更慢)。 - 图片存储:生成图片已镜像到平台 CDN,返回地址长期可用。
- 计费:按实际出图张数 × 分辨率档位计费;档位按实际像素面积判定(> 225 万像素为 2K)。
qwen-image-3.0的 1K/2K 同价;-pro的 2K 为 1K 的两倍。任务失败全额退款;参考图不额外收费。 - 常见错误:自定义
size宽或高不在 512–2048、比例越界、agent用在图生图、参考图不可访问或超 10MB 等返回 400;限流 429。
查询任务结果使用 获取任务状态 接口查询进度与
result.images。