给设计与内容团队交付图像生成能力，规范里最容易写错的一句是"支持透明背景"。这句话在阿里云百炼新上架的 Qwen-Image 2.1 族上是成立的，但它成立的位置不在文本生图那条命令上。规范里只写一句"支持透明"，不同的人会做出两种实现，其中一种拿不到透明像素。
阿里云百炼十月上了两个图像模型，qwen-image-2.1-pro 和 qwen-image-2.1-turbo。我把官方给这两个模型写的四条宣称（原生透明、生成与编辑一体化、多参考图编辑、排版与人像）逐条落到命令行工具 bl 上核了一遍。
计时与像素读数都是单次，每条都标了次数；单次读数不构成稳定性结论，规范也按这个方式落笔。
一、能力面：在架字段与两个默认值
核验从 bl model search 开始，这条命令不需要 API Key，可以放进流水线当前置闸：
bl model search --keyword qwen-image-2.1
返回 total 2，两个模型的 capabilities 均为 IG，modalities 输入 Text 与 Image、输出 Image，docUrl 同指一份 API 参考。从这三个字段能落两条规范判断：输入含 Image，说明编辑路径可用；docUrl 一致，说明两个模型共用一套参数口径，文档不必分开维护。
两个默认值要写进规范。第一，bl image generate 的默认模型是 qwen-image-3.0，调用 2.1 族必须显式传 --model；漏传不报错，图照出，跑的是另一个模型。第二，--watermark 省略时按帮助文本走 Profile 设置或 CLI 默认值 true，产物右下角带"AI 生成"角标；对外素材的规范里要明确这一项由谁决定，不能留给默认值。
鉴权口径：image generate 与 image edit 都要 Key，model search 不要。Key 在 API Key 签发页 签发，工具入口在 CLI 安装页，一条 npm 命令。
二、宣称与路径对照
| 官方宣称 | 生效路径 | 命令 | 读数 | 次数 |
|---|---|---|---|---|
| 原生透明 | 生成侧 | image generate 提示词写透明 |
全透明像素 0 个，全不透明 1,759,201 | 1 |
| 原生透明 | 编辑侧 | image edit 提示词写透明 |
turbo 全透明像素 164,919；pro 301,400 | 各 1 |
| 生成与编辑一体化 | 两侧同一模型 ID | --model 切换即可 |
同一模型两条命令都通 | 各 1 |
| 多参考图编辑 | 编辑侧 | --image 重复传 2 张 |
两源主体均在、左右并排 | 1 |
| 优雅排版 | 生成侧 | --size 3:4 招牌题 |
「山屿咖啡」四字清晰可读，立牌「今日特调」正确 | 1 |
四条宣称里三条当场成立，透明这条要先换路径才成立。官方 API 参考对两个 2.1 模型写的是同一句：图生图/图像编辑（I2I）支持传入最多 10 张参考图，且能够根据提示词描述自动决定输出普通图像还是带有透明通道的图像。文档里没有 transparent 或 RGBA 参数名，透明是由提示词描述触发的输出形态。
bl image generate --model qwen-image-2.1-turbo --prompt "一枚圆形徽章贴纸：蓝色山峰剪影，背景完全透明（alpha 通道透明，不要任何底色）" --size 1:1 --out-dir ./img21 --out-prefix t2
bl image edit --model qwen-image-2.1-turbo --image ./img21/t1.png --prompt "保留柠檬切片主体，把背景改成完全透明的 alpha 通道" --size 1:1 --out-dir ./img21 --out-prefix t3
生成侧那一次的产物同样是 RGBA 容器、1328×1328，容器带 alpha 通道与内容有透明像素是两件事。规范里应当把验收点写在像素上，不写在文件格式上。生成侧那一次为何没有透明像素，我没查明：帮助文本里没有相关开关，这份口径只记录现象与官方文档位置，不做机制推断。
三、团队规范五条（可直接抄进文档）
- 调用前核在架。 用
bl model search --keyword qwen-image-2.1确认模型名与 capabilities，模型 ID 不写死在配置里 --model显式传值。image generate的默认模型是 qwen-image-3.0，漏传不报错- 透明资产走编辑路径。 调用点放
image edit，透明写进提示词；验收用 alpha 直方图，全透明像素大于 0 才算通过 --watermark显式传值。 默认 true 会带角标，对外素材由规范指定取值，不依赖默认- 单次读数不进规范。 计时与像素数各 1 次的结果只作量级参考，写进文档前要按第四节判据重跑两次以上
四、验收判据表
| 判据 | 通过条件 | 核验方法 |
|---|---|---|
| 模型在架 | model search 返回含目标模型 ID，capabilities 为 IG |
命令行返回，不需 Key |
| 透明产出 | alpha 直方图全透明像素大于 0 | image edit 后用 PIL 读第四通道 |
| 多参考图 | 源主体数量与布局符合提示词 | --image 重复传参后目视核验 |
| 中文排版 | 目标字样清晰可读、无错字 | 生成后目视核验，逐字对 |
| 复现性 | 同 seed 两次逐像素一致 | 像素级差异比对，不看文件哈希 |
| 水印口径 | 产物角标与规范取值一致 | 显式传 --watermark 后核对右下角 |
复现性这一条要单独说明：同提示词同 seed（42）跑两次，逐像素比对完全一致、差异图为空，两个文件的 sha256 却不同，差在 PNG 容器元数据（2 次）。拿文件哈希当判据会误报失败。做复现实验时把 --prompt-extend 显式关掉，提示词扩写开着，同 seed 的输入本身不稳定。
五、参数与口径速查
| 参数 | 口径 | 来源 |
|---|---|---|
--model |
命中 2.1 族必填 | 帮助文本 |
--image |
仅 image edit；可重复，文档上限 10 张 |
帮助文本与 API 参考 |
--watermark |
省略即用 Profile 设置或 CLI 默认值 true | 帮助文本逐字 |
--size |
收比例（1:1、3:4）与像素（2048*2048），像素写法中间是星号 | 帮助文本 |
--seed |
可复现生成，判据用像素 | 帮助文本加 2 次核验 |
--prompt-extend |
提示词扩写开关，复现实验时关掉 | 帮助文本 |
--function |
只服务 wanx 系编辑模型，2.1 族不适用 | 帮助文本 |
模型选型口径：官方对 turbo 的定位是"目前 Qwen-Image 系列中综合表现与性价比最优的开源图像生成模型"，对 pro 的定位是"统一的文本到图像生成与图像编辑模型，视觉生成组件仅包含 70 亿参数（32 层单流 DiT）"，并写了"从照片中提取主体"。这一轮的单次读数是同一句提示词下 turbo 落盘 14 秒、pro 20 秒（各 1 次），编辑侧透明像素 turbo 164,919、pro 301,400（各 1 次）。四个数只够估量级，选型按路径需求定：要透明资产与多参考图走编辑侧，两个模型都支持。
六、资源纪律与零价格口径
输出目录与前缀由 --out-dir、--out-prefix 控制，不会覆盖既有资产。
花费与额度数字不进这份规范。这类数字有有效期，抄进文档就是过期源；用量与余量统一走控制台账单页与额度页，按当天读数看。规范里要写的是判据本身：哪条宣称落在哪条路径、哪个默认值必须显式覆盖、哪些读数会随模型换版变化。
会变的三类是模型在架名单、宣称口径、单次读数；命令签名与参数形态相对稳定。所以验收记录要连 bl 版本号一起留，过期读数不沿用。
七、边界与移交
不在这份口径里的：局部控制、高保真还原、"从照片中提取主体"三条宣称这一轮未核验；10 张参考图的上限行为、长文本与小字号排版、并发与限流表现同样未覆盖。另有一条移交事项：生成侧那一次没有透明像素，原因我没查明，需要平台侧确认后再回写进规范。
第三节五条与第四节判据表可以直接抄进团队文档，抄的时候把表头日期换成你们自己那次验收的日期，读数用你们那批素材的结果替换。控制台侧入口在 阿里云百炼首页，账单页与额度页从那里进。模型换版或上架新族时按同一套判据重跑一次，这份口径就不会过期。
