Qwen-Image-Layered使用全记录：每一步都清晰易懂

1. 引言

1.1 图像编辑的痛点与新思路

传统图像编辑依赖于手动抠图、蒙版绘制和图层管理，操作繁琐且容易破坏图像整体一致性。尤其是在处理复杂场景时，如前景与背景融合紧密的对象、半透明区域或包含文字的图像，常规工具往往难以精准分离语义内容。

Qwen-Image-Layered 提供了一种全新的解决方案——将单张图像自动分解为多个带透明通道（RGBA）的独立图层。这种“分层表示”不仅实现了物理隔离式的可编辑性，还天然支持高保真基础操作，如重着色、缩放、移动和删除等，极大提升了图像后期处理的效率与灵活性。

1.2 Qwen-Image-Layered 的核心价值

该项目由通义实验室推出，基于 Qwen2.5-VL 架构构建，专注于图像到多图层的分解任务。其最大优势在于：

无需人工干预即可完成高质量图层拆解
每个图层具备完整 Alpha 通道，保留边缘细节
支持导出为 PPTX 文件，便于在主流设计软件中继续编辑
提供可视化界面，零代码也能上手

本文将带你从部署、运行到实际应用，全面掌握 Qwen-Image-Layered 的使用方法，确保每一步都清晰易懂。

2. 环境准备与项目结构解析

2.1 前置依赖安装

要顺利运行 Qwen-Image-Layered，需确保以下依赖已正确安装：

# 安装最新版 diffusers（支持 Qwen 模型） pip install git+https://github.com/huggingface/diffusers # 安装 transformers（建议版本 >= 4.51.3） pip install transformers>=4.51.3 # 安装 python-pptx，用于导出分层结果为 PPTX pip install python-pptx

注意：推荐使用 CUDA 环境以加速推理过程。模型默认加载bfloat16格式，在 GPU 上运行更高效。

2.2 项目目录结构详解

下载仓库后，主要文件结构如下：

Qwen-Image-Layered/ ├── LICENSE # Apache License 2.0 ├── README.md # 项目说明文档 ├── assets/ │ └── test_images/ # 内置测试图像示例 └── src/ ├── app.py # 主 Gradio 应用入口（图像分解 + PPTX 导出） └── tool/ └── edit_rgba_image.py # 图层编辑专用界面

其中：

app.py是主交互界面，支持上传图像并一键生成分层结果。
edit_rgba_image.py集成了图层编辑功能，允许对单个图层进行修改、替换或删除。

3. 快速启动与服务部署

3.1 启动图像分解服务

进入项目根目录后，执行以下命令启动 Web 可视化界面：

cd /root/ComfyUI/ python main.py --listen 0.0.0.0 --port 8080

说明：虽然参考命令指向/root/ComfyUI/，但若直接使用 Qwen-Image-Layered 仓库，则应运行：
python src/app.py
默认启动地址为http://localhost:7860（Gradio 默认端口）。

访问该地址后，你会看到一个简洁的上传界面，支持拖拽图像进行图层分解。

3.2 使用 Gradio 界面进行图层分解

操作流程非常直观：

上传一张 RGBA 或 RGB 图像（推荐 PNG 格式）
设置参数：
- layers: 指定期望分解的图层数量（默认 4）
- resolution: 输入分辨率（建议 640）
- true_cfg_scale: 控制生成稳定性（建议 3.0~5.0）
点击 “Run” 按钮，等待几秒即可获得分解结果

输出包括：

多个独立的 PNG 图层（含透明通道）
一个打包好的.pptx文件，可在 PowerPoint 中直接编辑各图层

4. 编程调用：API 方式实现图像分层

4.1 加载模型与预处理

对于开发者而言，可通过 Python 脚本直接调用QwenImageLayeredPipeline实现自动化处理。

from diffusers import QwenImageLayeredPipeline import torch from PIL import Image # 加载模型 pipeline = QwenImageLayeredPipeline.from_pretrained("Qwen/Qwen-Image-Layered") pipeline = pipeline.to("cuda", torch.bfloat16) # 加载输入图像 image = Image.open("assets/test_images/1.png").convert("RGBA")

4.2 配置推理参数

关键参数说明如下：

参数名	说明
`image`	输入图像（PIL.Image 对象）
`generator`	随机种子生成器，控制输出一致性
`true_cfg_scale`	条件控制强度，影响图层分离清晰度
`negative_prompt`	负向提示词（可留空）
`num_inference_steps`	推理步数（建议 50）
`layers`	分解图层数（通常 3~6）
`resolution`	处理分辨率（640 为平衡点）
`cfg_normalize`	是否启用 CFG 归一化
`use_en_prompt`	是否使用英文提示辅助

inputs = { "image": image, "generator": torch.Generator(device='cuda').manual_seed(777), "true_cfg_scale": 4.0, "negative_prompt": " ", "num_inference_steps": 50, "layers": 4, "resolution": 640, "cfg_normalize": True, "use_en_prompt": True, }

4.3 执行推理并保存结果

with torch.inference_mode(): output = pipeline(**inputs) # 保存每个图层 for i, layer in enumerate(output.images[0]): layer.save(f"layer_{i}.png")

此时你将得到layer_0.png,layer_1.png... 等多个文件，每个均为 RGBA 格式，可单独编辑。

5. 图层编辑功能详解

5.1 启动图层编辑工具

除了分解图像外，Qwen-Image-Layered 还提供了专门的图层编辑能力：

python src/tool/edit_rgba_image.py

该脚本启动另一个 Gradio 界面，支持以下高级操作：

单图层重新着色
替换图层内容（结合 Qwen-Image-Edit）
删除指定图层
调整图层尺寸与位置
修改 OCR 文字内容（适用于文本图层）

5.2 实际编辑案例演示

案例一：修改某一层的颜色

上传已分解的图层组 → 选择目标图层 → 输入颜色调整指令（如“把红色汽车变成蓝色”）→ 模型自动重绘该图层，其余保持不变。

案例二：删除背景图层

选择不需要的图层（如纯色背景），点击“Delete Layer”，系统会自动合成剩余图层并预览效果。

案例三：调整对象大小与位置

通过内置的空间变换模块，可以对特定图层执行：

自由缩放（resize）
平移移动（move object）
旋转（rotate，实验性）

这些操作均不会影响其他图层的完整性，真正实现“非破坏性编辑”。

6. 高级技巧与优化建议

6.1 自定义分层数与进一步分解

默认情况下，模型会尝试将图像分为 4 层。但你可以根据需求调整layers参数：

简单图像（如图标、海报）：设置layers=3即可充分分解
复杂场景（多人物、多层次）：可尝试layers=6或更高

此外，对于某些未完全分离的组件，可对某一图层再次输入模型进行二次分解（further decomposition），实现更精细的控制。

6.2 利用文本提示提升分解质量

尽管当前模型不支持精确控制单个图层语义，但可通过use_en_prompt=True启用英文描述辅助分解。

例如，在输入图像的同时附加一句描述：“A red car parked in front of a white house with trees”，有助于模型更好理解遮挡关系和层次结构。

6.3 输出格式扩展建议

目前官方支持导出为.pptx，适合设计师使用。但也可自行扩展导出逻辑，支持：

Photoshop PSD 格式（保留图层结构）
JSON + Base64 编码（便于 Web 应用集成）
视频帧序列（用于动态编辑）

7. 功能对比与适用场景分析

7.1 与其他图像编辑技术对比

特性	传统抠图工具	AI 抠图（如 Remove.bg）	Qwen-Image-Layered
是否需要手动标注	是	否	否
支持多图层分离	否	否（仅前景/背景）	✅ 是
图层可独立编辑	❌（合并后丢失）	❌	✅
支持重着色/替换	有限	有限	✅ 高保真
支持导出 PPTX	否	否	✅
文本图层识别	否	否	✅（可修改 OCR 内容）