千问出图 1317209322/qwen-image-skill

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。可自由使用、修改、商用，保留版权声明即可。

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