qwen-image

name	qwen-image
description	Generate images using Alibaba Cloud Bailian Qwen-Image and Z-Image models (通义千图文生图 + 人像照片模型)
homepage	https://help.aliyun.com/zh/model-studio/qwen-image-api
metadata	{"openclaw":{"emoji":"🎨"},"requires":{"env":["DASHSCOPE_API_KEY"]}}

Qwen-Image / Z-Image Skill

基于阿里云百炼的文图生成技能，智能识别场景自动选择最佳模型：

• 🧍 人像/照片 → z-image-turbo（专精高质量人像，支持胶片质感）
• 🖼️ 通用文图 → qwen-image-max（擅长复杂文字渲染、艺术风格）

Features

• 🤖 智能模型选择：自动检测人像场景，无需手动选择模型
• 🎨 双模型支持：Qwen-Image（通用） + Z-Image（人像）
• ✍️ 中文文字渲染：在图像中完美呈现复杂中文字符
• 📐 多尺寸支持：16:9、4:3、1:1、3:4、9:16 等多种比例
• 🔧 可手动指定：支持强制使用特定模型

Setup

1. 从 阿里云百炼控制台 获取 API Key
2. 配置方式选择其一：
   • 环境变量：export DASHSCOPE_API_KEY="sk-xxx"
   • TOOLS.md：在 TOOLS.md 中添加 DASHSCOPE_API_KEY: sk-xxx

地域注意：北京和新加坡地域 API Key 不互通

Available Models

模型	描述	最佳场景
qwen-image-max	最佳质量，减少AI痕迹，文字渲染优秀	漫画、插画、图文设计、风景、静物
qwen-image-plus	质量与速度平衡	通用场景
qwen-image	基础模型	快速生成
z-image-turbo	人像专精，胶片质感，真实感强	人像照片、人像写真、film grain效果

Supported Sizes

尺寸	比例	说明
1664*928	16:9	横向宽屏（通用默认）
1472*1104	4:3	标准比例
1328*1328	1:1	方形
1104*1472	3:4	竖向
928*1664	9:16	手机竖屏
1120*1440	4:5	人像推荐

Usage

🎯 快速入门（推荐）

直接写提示词，自动识别场景并选择最佳模型：

# 人像类 → 自动使用 z-image-turbo
python scripts/generate.py "短发少女，清新自然风格，微笑"

# 通用类 → 自动使用 qwen-image-max
python scripts/generate.py "七龙珠孙悟空对战比克大魔王，漫画风格"

# 含film grain关键词 → 自动使用 z-image
python scripts/generate.py "胶片感，Kodak Portra 400风格的人像"

🔧 高级选项

python scripts/generate.py "prompt" \
    --model z \              # 强制指定模型 (z/qwen/auto)
    --size 1328*1328 \       # 图片尺寸
    --prompt-extend \        # 开启提示词扩展
    --no-watermark \         # 禁用水印
    --output my-image.png    # 输出路径

Auto-Detection Keywords

以下关键词会触发自动选择 z-image-turbo：

人物类：人、女、男、少女、帅哥、美女、肖像、人物、face、facial

照片/胶片类：photo、photograph、film grain、analog、Kodak、胶片、portra、cinematic、photorealistic、真实、写真人像

使用示例

人像照片（z-image）

python scripts/generate.py "东亚年轻女性，户外雪地场景，film grain效果，胶片质感"

漫画风格（qwen-image）

python scripts/generate.py "七龙珠孙悟空对战比克大魔王，漫画风格，能量波爆炸，天空背景"

带中文文字的漫画

python scripts/generate.py "一副对联，上联：智启千问，下联：机道为善，横批：人机共生"

Tips

• 人像首选 z-image：对面部细节、皮肤质感、胶片感优化更好
• 文字渲染选 qwen：复杂中文、图文混排场景更精准
• 自动模式省心：无需纠结选哪个模型
• 提示词长度：正向 ≤800字符，负向 ≤500字符
• 扩展提示词：--prompt-extend 可以让AI自动优化你的描述

---

Qwen-Image Skill - 国产文生图利器 🇨🇳