| name | aliyun-qwen-image |
| description | 阿里云百炼Qwen-Image文生图API调用助手 - 用于通过阿里云百炼平台调用Qwen-Image系列模型生成高质量图像。支持同步和异步调用方式、提示词智能改写、多分辨率输出、反向提示词等高级功能。触发场景：(1) 用户需要生成图像 (2) 用户提到文生图、AI绘画 (3) 用户询问阿里云百炼图像生成 (4) 需要批量生成图片 (5) 需要定制化图像生成参数 |
阿里云百炼 Qwen-Image 文生图 Skill
基本信息
- 名称: aliyun-qwen-image
- 版本: 1.0.0
- 分类: AI服务调用
- 优先级: P1
- 创建日期: 2026-05-11
- 更新日期: 2026-05-11
功能描述
通过阿里云百炼平台调用Qwen-Image系列文生图模型，生成高质量图像。支持同步和异步两种调用方式，提供提示词智能改写、多分辨率输出、反向提示词过滤等高级功能。
触发条件
- 命令触发:
/qwen-image
- 关键词触发:
- "文生图"
- "AI绘画"
- "生成图片"
- "图像生成"
- "阿里云图像"
- "百炼生图"
- "qwen image"
- "wanx"
支持的模型
图像生成模型 (IG)
| 模型名称 | 调用方式 | 特点 | 价格 | 推荐场景 |
|---|
qwen-image-max | 同步 | 最高质量版本 | - | 最高质量需求 |
qwen-image-2.0-pro | 同步 | 满血版，最强文字渲染和真实质感 | 0.5元/张 | 高质量单图生成 (推荐) |
qwen-image-2.0 | 同步 | 加速版，效果与性能平衡 | 0.2元/张 | 快速图像生成 |
qwen-image-plus | 异步 | Plus版本 | - | 批量生成 |
qwen-image | 异步 | 基础版本 | - | 快速异步生成 |
图像编辑模型
| 模型名称 | 用途 |
|---|
qwen-image-edit-plus | 图像编辑 (Plus版本) |
qwen-image-edit | 图像编辑 (基础版本) |
视频生成模型 (VG)
| 模型名称 | 特点 | 价格 |
|---|
wan2.7-i2v | 图生视频，演绎能力升级 | 1元/秒(1080P) |
wan2.7-t2v | 文生视频 | - |
wan2.7-r2v | 参考生视频，支持5个混合参考 | 1元/秒(1080P) |
详细模型列表见 references/models.md
输入参数
必选参数
| 参数名 | 类型 | 描述 | 示例值 |
|---|
| prompt | string | 正向提示词，描述期望的图像内容，支持中英文，不超过800字符 | "一只坐着的橘黄色的猫，表情愉悦，活泼可爱" |
| model | string | 模型名称 | qwen-image-2.0-pro |
可选参数
| 参数名 | 类型 | 默认值 | 描述 |
|---|
| negative_prompt | string | "" | 反向提示词，描述不希望出现的内容，不超过500字符 |
| size | string | 2048*2048 | 输出图像分辨率，格式为宽*高 |
| watermark | boolean | false | 是否添加"Qwen-Image"水印 |
| prompt_extend | boolean | true | 是否开启提示词智能改写 |
| seed | integer | 随机 | 随机数种子，范围[0,2147483647] |
| n | integer | 1 | 生成图像数量，当前固定为1 |
推荐分辨率
qwen-image-2.0系列 (512512 ~ 20482048)
| 分辨率 | 宽高比 | 用途 |
|---|
| 2688*1536 | 16:9 | 横屏壁纸、视频封面 |
| 1536*2688 | 9:16 | 手机壁纸、短视频封面 |
| 2048*2048 | 1:1 | 社交媒体头像、商品图 |
| 2368*1728 | 4:3 | 传统显示器、PPT |
| 1728*2368 | 3:4 | 竖版展示 |
qwen-image-max/plus系列
| 分辨率 | 宽高比 |
|---|
| 1664*928 | 16:9 (默认) |
| 1472*1104 | 4:3 |
| 1328*1328 | 1:1 |
| 1104*1472 | 3:4 |
| 928*1664 | 9:16 |
执行流程
方式一：同步调用（qwen-image-2.0系列）
- 准备参数 - 设置model、prompt、size等参数
- 发送请求 - 调用同步API接口
- 获取结果 - 直接返回生成的图像URL
- 下载保存 - 图像URL有效期24小时，需及时保存
方式二：异步调用（qwen-image-plus/image系列）
- 创建任务 - 发送请求获取task_id
- 轮询查询 - 使用task_id查询任务状态
- 等待完成 - 状态从PENDING→RUNNING→SUCCEEDED
- 获取结果 - 任务成功后获取图像URL
- 下载保存 - 及时保存图像
API接口详情
同步接口
请求地址:
POST https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
请求头:
Content-Type: application/json
Authorization: Bearer $DASHSCOPE_API_KEY
请求体示例:
{
"model": "qwen-image-2.0-pro",
"input": {
"messages": [
{
"role": "user",
"content": [
{"text": "一只坐着的橘黄色的猫，表情愉悦，活泼可爱"}
]
}
]
},
"parameters": {
"negative_prompt": "低分辨率，低画质，肢体畸形，手指畸形",
"prompt_extend": true,
"watermark": false,
"size": "2048*2048"
}
}
异步接口
创建任务地址:
POST https://dashscope.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesis
请求头:
Content-Type: application/json
Authorization: Bearer $DASHSCOPE_API_KEY
X-DashScope-Async: enable
查询任务地址:
GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}
响应格式
成功响应
{
"output": {
"choices": [
{
"finish_reason": "stop",
"message": {
"role": "assistant",
"content": [
{"image": "https://dashscope-result.xxx.aliyuncs.com/xxx.png?Expires=xxx"}
]
}
}
]
},
"usage": {
"height": 2048,
"image_count": 1,
"width": 2048
},
"request_id": "d0250a3d-b07f-49e1-bdc8-xxx"
}
异步任务响应
{
"output": {
"task_id": "0385dc79-5ff8-4d82-bcb6-xxx",
"task_status": "PENDING"
},
"request_id": "4909100c-7b5a-9f92-xxx"
}
使用示例
示例1：基础图像生成
输入:
生成一张橘猫的图片，表情愉悦，可爱风格
执行:
import dashscope
from dashscope import MultiModalConversation
response = MultiModalConversation.call(
model="qwen-image-2.0-pro",
messages=[{
"role": "user",
"content": [{"text": "一只坐着的橘黄色的猫，表情愉悦，活泼可爱，逼真准确"}]
}],
size="2048*2048"
)
输出摘要: 返回2048*2048分辨率PNG图像URL
示例2：高清壁纸生成
输入:
生成一张16:9的风景壁纸，冬日北京街景，中式建筑风格
执行:
curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation' \
--header 'Authorization: Bearer $DASHSCOPE_API_KEY' \
--data '{
"model": "qwen-image-2.0-pro",
"input": {
"messages": [{"role": "user", "content": [{"text": "冬日北京的都市街景，中式建筑"}]}]
},
"parameters": {"size": "2688*1536"}
}'
示例3：异步批量生成
输入:
异步生成多张产品宣传图，需要高分辨率
执行:
- 创建异步任务获取task_id
- 轮询查询任务状态（建议间隔10秒）
- 获取生成结果
质量标准
- 图像质量: PNG格式，支持最高2048*2048分辨率
- 响应时效: 同步接口秒级响应，异步接口需轮询等待
- 链接有效期: 生成图像URL有效期24小时
- 提示词长度: 正向不超过800字符，反向不超过500字符
依赖工具
- DashScope SDK - Python/Java官方SDK
- curl - HTTP命令行工具
- Postman - API调试工具
注意事项
- API Key配置: 需配置环境变量
DASHSCOPE_API_KEY或直接传入
- 地域选择: 北京和新加坡地域API Key不同，注意区分
- 图像保存: URL有效期24小时，务必及时下载保存
- 异步轮询: 建议间隔10秒查询，避免频繁请求
- RPS限制: 异步查询接口默认RPS为20
- 费用计量: 按图像分辨率和数量计费，注意控制成本
错误处理
| 错误码 | 说明 | 解决方案 |
|---|
| InvalidApiKey | API Key无效 | 检查API Key配置 |
| InvalidParameter | 参数错误 | 检查参数格式和取值范围 |
| ModelNotFound | 模型不存在 | 使用支持的模型名称 |
快速参考
常用命令
| 命令 | 说明 |
|---|
/qwen-image | 快速生成图像 |
/qwen-image --async | 异步生成图像 |
/qwen-image --size=2048*2048 | 指定分辨率 |
常用特性
| 特性 | 说明 |
|---|
| prompt_extend | 提示词智能改写，优化生成效果 |
| negative_prompt | 反向提示词，排除不希望的内容 |
| seed | 固定种子值，保持生成结果相对稳定 |
相关文档
技能版本: 1.0.0
最后更新: 2026-05-11
创建者: AI Assistant
