Skip to main content
POST
  • 异步处理模式,返回任务ID用于后续查询
  • 支持文生图、图生图等多种生成模式
  • 支持 1K/2K 分辨率档位,最多生成 6 张图片

支持的模型

Authorizations

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

Body

string
required
模型名称
  • qwen-image-2.0 - 标准版,效果与性能平衡
  • qwen-image-2.0-pro - Pro 版,文字渲染更强、写实质感更细腻
string
required
图像生成的文本描述,最多 800 字符
string
default:"1:1"
图像宽高比支持的宽高比:
  • 1:1 - 正方形(默认)
  • 4:3 - 横向 4:3
  • 3:4 - 纵向 3:4
  • 16:9 - 横向宽屏
  • 9:16 - 纵向竖屏
  • 3:2 - 横向 3:2
  • 2:3 - 纵向 2:3
string
default:"1K"
分辨率档位
  • 1K - 标准分辨率(默认)
  • 2K - 高清分辨率
integer
default:"1"
生成图片张数取值范围:1-6
string
反向提示词(不希望出现的内容),最多 500 字符
array
参考图片 URL 数组(图生图模式)限制:
  • 必须是公网可访问的 URL
  • 不支持 base64 格式

尺寸对照表

通过 size(比例)+ resolution(分辨率档位)组合控制输出尺寸。
  • 只传 size → 默认 1K 档位:{"size": "16:9"} → 1280×720
  • size + resolution → 指定档位:{"size": "16:9", "resolution": "2K"} → 2048×1152

使用场景示例

文生图(最简请求)
指定比例和张数
高清 2K 档位
图生图(参考图 + 文字描述)

Response

integer
响应状态码
array
返回数据数组

注意事项

  1. 异步处理:提交后返回 task_id,需轮询 /v1/tasks/{task_id} 获取结果
  2. 图片存储:生成的图片已镜像到平台 CDN,长期有效
  3. 计费规则:按成功生成的图片张数计费,失败不扣费
  4. 图片 URL 要求:输入图片必须是公网可访问的 URL,不支持 base64