%20(1).png)
ComfyUI-DreamO 插件完全教程
1. 插件简介
插件地址： https://github.com/ToTheBeginning/ComfyUI-DreamO
ComfyUI-DreamO 是一个超级厉害的图像处理插件，它就像一个神奇的魔法师，能够把你的照片变成各种风格的艺术作品！这个插件基于字节跳动（ByteDance）开发的 DreamO 模型，专门用来做图像风格转换、人物换脸、背景替换等酷炫效果。
这个插件能给我们带来什么效果？
- 🎨 风格转换：把你的照片变成油画、水彩画、卡通风格等各种艺术风格
- 👤 人脸替换：把一个人的脸换到另一个人身上，就像换头术一样神奇
- 🖼️ 图像参考：用一张图片作为参考，让AI生成类似风格或内容的新图片
- 🎭 多种任务模式：支持不同的处理方式，满足各种创作需求
简单来说，这就是一个让你的照片"变身"的神器！
2. 如何安装
方法一：手动安装（推荐）
- 打开你的 ComfyUI 文件夹
- 进入
custom_nodes文件夹 - 在这里打开命令行（终端）
- 输入以下命令：
git clone https://github.com/ToTheBeginning/ComfyUI-DreamO.git
- 进入插件文件夹：
cd ComfyUI-DreamO
- 安装依赖：
pip install -r requirements.txt
- 重启 ComfyUI
需要下载的模型文件
安装完插件后，你还需要下载一些"大脑文件"（模型文件）：
FLUX 基础模型（如果你已经有了可以跳过）：
- 主模型：放到
ComfyUI/models/checkpoints/文件夹 - 文本编码器：放到
ComfyUI/models/clip/文件夹 - VAE：放到
ComfyUI/models/vae/文件夹
DreamO 专用模型：
- 从 https://huggingface.co/ByteDance/DreamO/tree/main/comfyui 下载所有
.safetensors文件 - 放到
ComfyUI/models/loras/文件夹 - 🔥 v1.1版本：从 https://huggingface.co/ByteDance/DreamO/tree/main/v1.1 下载更新版本
自动下载的文件（插件会自动处理）：
- dreamo-embedding：用于图像理解的"词典"
- ben2：用于背景移除的"橡皮擦"
3. 节点详细解析
3.1 DreamOProcessorLoader 节点
这个节点是干嘛的？
这就像是一个"工具箱管理员"，它负责准备和加载所有需要用到的工具。就像你要做菜之前，先把锅碗瓢盆都准备好一样。这个节点会加载两个重要的工具：一个是专门用来"抠图"（移除背景）的BEN2模型，另一个是专门用来"找脸"（检测和对齐人脸）的facexlib模型。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 无参数 | 无参数 | 无参数 | 无参数 | 这个节点不需要你设置任何东西，它会自动工作 | 该节点无需输入参数，自动加载预训练模型 | 直接连接到工作流中即可，就像插上电源一样简单 |
输出接口：
DREAMO_PROCESSOR：输出一个"工具包"，包含了后续处理需要的所有工具
3.2 DreamORefEncode 节点
这个节点是干嘛的？
这是一个"图片翻译官"，它的工作就是把你输入的参考图片"翻译"成AI能理解的语言。就像把中文翻译成英文一样，这个节点把图片翻译成数字信号。根据你选择的任务类型，它会用不同的方式来处理图片：比如如果是换脸任务，它会先找到脸部并裁剪；如果是去背景任务，它会先把背景去掉。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| pixels | pixels | IMAGE类型 | 必须连接 | 这是你要处理的参考图片，就像给翻译官一份文件 | 输入的原始图像数据，tensor格式 | 把你想要作为参考的图片连接到这里，比如一张人脸照片或风格图片 |
| vae | vae | VAE类型 | 必须连接 | 这是一个"压缩器"，把图片压缩成AI更容易处理的格式 | 变分自编码器，用于图像编码解码 | 连接你的VAE模型，通常是从模型加载器来的 |
| dreamo_processor | dreamo_processor | DREAMO_PROCESSOR类型 | 必须连接 | 这是从上一个节点来的"工具包" | DreamO处理器实例，包含BEN2和face helper | 连接DreamOProcessorLoader节点的输出 |
| resolution | resolution | 整数 | 512 | 这决定了处理图片的清晰度，就像调节相机的像素一样 | 参考图像的目标分辨率，影响处理质量和速度 | 512适合大多数情况，如果要更清晰可以设置768或1024 |
| ref_task | ref_task | 下拉选择 | "ip" | 这是选择处理方式的开关，告诉AI你想做什么类型的任务 | 参考任务类型，决定预处理方式 | "ip"去背景，"id"换脸，"style"保持背景做风格转换 |
ref_task 参数详细说明：
- "ip"：会自动去掉图片背景，适合做物体替换或背景合成
- "id"：会自动找到并裁剪人脸，适合做人脸替换，效果类似PuLID
- "style"：保持原图背景，适合做风格转换，但需要在提示词中激活风格转换
输出接口：
LATENT：翻译后的图片数据，AI能理解的格式IMAGE：处理后的图片预览，你可以看到处理效果
3.3 ApplyDreamO 节点
这个节点是干嘛的？
这是整个魔法的"施法器"！它把前面准备好的参考图片信息"注入"到AI模型中，就像给AI装上了一副"参考眼镜"，让AI在生成新图片时能够参考你提供的图片。这个节点最多可以同时使用3张参考图片，让AI同时参考多个图片来生成更丰富的效果。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| model | model | MODEL类型 | 必须连接 | 这是AI的"大脑"，负责生成图片的主要模型 | FLUX扩散模型实例，用于图像生成 | 连接你的FLUX模型，通常来自模型加载器 |
| ref1 | ref1 | LATENT类型 | 必须连接 | 第一张参考图片的"翻译版本"，这是主要参考 | 第一个参考图像的潜在空间表示 | 连接DreamORefEncode节点的LATENT输出，作为主要参考 |
| ref2 | ref2 | LATENT类型 | 可选连接 | 第二张参考图片，可以增加更多参考信息 | 第二个参考图像的潜在空间表示，可选 | 如果想要多重参考效果，可以连接第二个DreamORefEncode的输出 |
| ref3 | ref3 | LATENT类型 | 可选连接 | 第三张参考图片，让参考更加丰富 | 第三个参考图像的潜在空间表示，可选 | 最多可以同时参考三张图片，让生成效果更复杂 |
输出接口：
MODEL：装备了参考信息的AI模型，可以直接用于图片生成
4. 使用技巧和建议
4.1 基础使用流程
- 加载工具：先连接
DreamOProcessorLoader节点 - 准备参考：用
DreamORefEncode处理你的参考图片 - 应用魔法：用
ApplyDreamO把参考信息注入到模型中 - 生成图片：连接到采样器开始生成
4.2 任务类型选择建议
- 人脸替换：选择 "id" 模式，参考图片最好是清晰的正脸照
- 风格转换：选择 "style" 模式，记得在提示词中描述想要的风格
- 物体替换：选择 "ip" 模式，参考图片背景会被自动去除
4.3 参数调优建议
- 分辨率设置：
- 512：速度快，适合测试
- 768：平衡质量和速度
- 1024：最高质量，但速度较慢
- 多参考使用：可以同时使用多张参考图片，但要注意不要让参考信息过于复杂
4.4 性能优化
- 使用较小的分辨率进行测试，确定效果后再用高分辨率
- 如果显存不足，可以降低批次大小
- 建议使用 CFG=1，因为当前版本不支持真正的CFG
5. 常见问题解答
Q1: 为什么我的图片没有参考效果？
A: 检查以下几点：
- 确保所有节点都正确连接
- 检查参考图片是否清晰
- 确认任务类型选择是否正确
- 如果是风格转换，确保提示词中包含风格描述
Q2: 人脸检测失败怎么办？
A:
- 确保参考图片中的人脸清晰可见
- 尝试使用正脸照片而不是侧脸
- 如果还是失败，系统会自动切换到去背景模式
Q3: 生成速度很慢怎么办？
A:
- 降低分辨率设置（从1024降到768或512）
- 减少参考图片数量
- 检查显卡内存是否充足
Q4: 安装时出现依赖错误？
A:
- 确保安装了正确版本的 facexlib（必须是fork版本）
- 重新运行
pip install -r requirements.txt - 检查Python环境是否正确
Q5: 模型文件下载失败？
A:
- 检查网络连接
- 手动下载模型文件到指定文件夹
- 确保文件夹路径正确
6. 工作流示例
插件作者提供了几个示例工作流，你可以在插件的 workflows 文件夹中找到：
dreamo_comfyui_v1.1.json：最新版本工作流（推荐）dreamo_comfyui_2cond.json：双条件参考工作流dreamo_comfyui.json：基础工作流
7. 版本更新说明
v1.1 版本新特性（2025.06.24发布）
- 🎨 显著提升图像质量
- 🔧 减少身体构图错误
- ✨ 增强美学效果
- 🤝 可与 Super-Realism LoRA 结合使用获得更真实的效果
8. 注意事项
- CFG设置：当前版本需要在采样器中设置 CFG=1
- 兼容性：基于2025.5.19版本的ComfyUI开发，旧版本可能存在兼容问题
- 显存需求：处理高分辨率图片需要较大显存
- 模型依赖：需要正确安装FLUX模型和DreamO专用模型
9. 技术原理简介
DreamO插件的工作原理就像一个"图片参考助手"：
- 预处理阶段：根据任务类型对参考图片进行预处理（去背景、人脸检测等）
- 编码阶段：将处理后的图片转换为AI能理解的数字表示
- 注入阶段：将参考信息注入到生成模型中
- 生成阶段：AI在生成新图片时会参考这些信息
这个过程就像给AI提供了一个"参考手册"，让它知道你想要什么样的效果。
10. 总结
ComfyUI-DreamO是一个功能强大的图像参考生成插件，它让AI图像生成变得更加可控和精确。无论你是想做人脸替换、风格转换还是创意合成，这个插件都能为你提供强大的支持。
记住，熟练使用这个插件的关键是：
- 理解不同任务类型的用途
- 选择合适的参考图片
- 合理设置参数
- 多多实践和尝试
现在就开始你的创意之旅吧！🎨✨