Skip to main content
POST

支持的模型

排版密集、字多的场景优先用 -pro;常规出图用 qwen-image-3.0。提示词最长约 4.5k token。模型名与 2.0 系列不兼容互换。

Authorizations

string
必填
所有接口均需要使用 Bearer Token 进行认证获取 API Key:访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加:

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:4
  • 16:9 / 9:16
  • 3: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 的差异

注意事项

  1. 异步处理:提交后返回 task_id,使用 获取任务状态 轮询;建议每 3~5 秒一次,超时约 3 分钟(2K + 多张更慢)。
  2. 图片存储:生成图片已镜像到平台 CDN,返回地址长期可用。
  3. 计费:按实际出图张数 × 分辨率档位计费;档位按实际像素面积判定(> 225 万像素为 2K)。qwen-image-3.0 的 1K/2K 同价;-pro 的 2K 为 1K 的两倍。任务失败全额退款;参考图不额外收费。
  4. 常见错误:自定义 size 宽或高不在 512–2048、比例越界、agent 用在图生图、参考图不可访问或超 10MB 等返回 400;限流 429。
查询任务结果使用 获取任务状态 接口查询进度与 result.images