--- 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 - 国产文生图利器 🇨🇳