qwen-image

同一个模型，会写提示词和不会写，出图质量差着一整个档次。

AI 生图的瓶颈很少在模型，在提示词。qwen-image 把「把要求说细」做成了一套流程：接到需求先拆解意图，按镜头、光线、主体、材质、背景、影调逐层落定，交给 Qwen-Image-3.0-Pro 出图，交付前还要放大检查手部、反查提示词里有没有脑补用户没提的东西。

中文文字渲染与排版	写实人像 · 多光源	图生图 · 换场景

它比「直接调 API」多了什么

提示词方法论。 六个维度怎么铺陈、不同题材该给哪一层最多笔墨、抽象词（「疲惫」「高级感」这类）怎么翻译成模型能渲染的物理描述。

实测踩出来的坑。 避坑清单里每条都对应一张跑砸的图：侧写会引出用户没要的东西、指定焦点落点模型不会执行、状态写得太含蓄会被美颜抹平、手是结构性高风险区、模型会自己补场景道具。

反同质化约束。 防止每次生成都长一个样——不固定起手维度、不套固化短语、不默认画人像。

可复现。 每次生成都写一份同名 JSON，存下完整提示词、全部参数和 request_id。想改图时读它，只动要变的那一层，其余保持不变。

安装

npx skills add 1317209322/qwen-image-skill

怎么用

装好之后不用记命令，说人话就行：

画一张雨夜东京街头，霓虹灯下穿黑色风衣的女性侧身回头，胶片颗粒质感

把 photo.png 改成夜景，霓虹反射在湿路面上

做一张信息图海报，标题「季度报告」，三栏图标配小字说明，米白背景

想手敲也行：

& "<skill目录>\scripts\qwen-image.ps1" -Prompt "一只戴墨镜的柴犬，赛博朋克霓虹街景"

& "<skill目录>\scripts\qwen-image.ps1" -Prompt "改成夜景" -Image ".\photo.png"

& "<skill目录>\scripts\qwen-image.ps1" -Prompt "同一个角色的三视图设定稿" -N 3

前置条件

• Windows 10/11。脚本用 PowerShell 写成，其他平台需要自行改写（API 调用逻辑是通用的）
• PowerShell 7+，不是系统自带的 5.1。验证：pwsh -v
• 阿里云百炼 API Key。没有的话去 百炼控制台 开通后创建
• Key 的存放方式二选一：设为环境变量 QWEN_TOKEN_PLAN_CN_API_KEY，或写进 $DSH_HOME/.credentials.yaml（DSH 环境）／~/.dsh/.credentials.yaml

脚本不会把 Key 写进任何输出文件，生成的 JSON 记录里也不含密钥。

能做什么

能力	说明
文生图	默认旗舰 qwen-image-3.0-pro，可降级 qwen-image-3.0
图生图	传 1 到 3 张参考图，换场景、换装、换风格，人物特征可保持
中文文字	中文大字、密集小字、中英混排，10px 级小字也能精准渲染
批量出图	-N 一次出 1 到 6 张
参数自检	-DryRun 只打印请求体不发送，核对无误再花钱

已知限制

• 仅 Windows。其他平台需要自行改写脚本
• 计费按张。1K 档约 $0.034／张，2K 档约 $0.069／张，从你的百炼账户扣
• 接口 RPM 限制为 5，连续批量出图要控制节奏
• 手部是模型固有弱项。复杂双手动作容易崩，skill 里给了规避策略但无法根治
• 不指定题材时不会默认画人像，这是刻意设计，避免产出趋同

常见问题

现象	原因	解决
找不到 API Key	环境变量没设，凭据文件也不在默认位置	设 QWEN_TOKEN_PLAN_CN_API_KEY，或把 key 写进 ~/.dsh/.credentials.yaml
InvalidApiKey	Key 与端点域名不匹配	确认用的是百炼标准 Key，且端点走 dashscope.aliyuncs.com
Model not exist	模型名拼错，或该地域未开通此模型	用 -DryRun 核对请求体里的 model 字段
图生图不支持 -PromptExtendMode agent	agent 增强仅支持文生图	去掉该参数，图生图用默认的 direct
手部畸形	模型固有弱项，与提示词质量无关	降低手部动作复杂度，或让它部分被遮挡，不要整只手移出画面
生成的图和上一张很像	提示词结构固化了	换一个起手维度，别总从镜头层开始；别复用上次的措辞

License

MIT。可自由使用、修改、商用，保留版权声明即可。

---

文档里关于模型行为的判断来自实测，模型表现可能随版本更新变化。遇到与文档不符的情况，以实测为准。