%20(1).png)
ComfyUI-IPAdapter-Flux 插件保姆级教程
1. 插件简介
插件地址： https://github.com/Shakker-Labs/ComfyUI-IPAdapter-Flux
这个插件是专门为 ComfyUI 设计的图像适配器工具，它的作用就像是一个"图片参考助手"。想象一下，你有一张很喜欢的图片，希望 AI 生成的新图片能够参考这张图的风格、构图或者某些特征，这个插件就能帮你实现这个愿望。
主要功能：
- 让 AI 生成图片时参考你提供的图片
- 可以控制参考图片的影响强度（就像调节音量大小一样）
- 可以设置在生成过程的哪个阶段使用参考图片
- 支持同时使用多张参考图片
能带来什么效果：
- 生成的图片会更符合你的期望风格
- 可以保持某些特定的视觉元素
- 让 AI 创作更加可控和精准
2. 如何安装
方法一：手动安装（推荐）
- 打开你的 ComfyUI 安装目录，找到
custom_nodes文件夹 - 在
custom_nodes文件夹里打开终端/命令行 - 输入命令：
git clone https://github.com/Shakker-Labs/ComfyUI-IPAdapter-Flux.git - 进入插件文件夹：
cd ComfyUI-IPAdapter-Flux - 安装依赖：
pip install -r requirements.txt
下载模型文件
- 下载 IPAdapter 模型文件到
ComfyUI/models/ipadapter-flux/目录 - 下载视觉编码器到
ComfyUI/models/clip_vision/目录
重启 ComfyUI
安装完成后重启 ComfyUI，你就能在节点列表中看到新的 IPAdapter 节点了。
3. 节点详细解析
3.1 IPAdapterFluxLoader 节点（加载器节点）
这个节点是干嘛的？
这个节点就像一个"工具箱管理员"，它的工作是把 IPAdapter 模型和视觉识别工具准备好，让后面的节点可以使用。就像你要做菜之前，先要把锅碗瓢盆都准备好一样。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| ipadapter | ipadapter | 下拉选择模型文件 | 选择你下载的模型 | 选择要使用的图片适配器模型，就像选择不同的画笔 | 指定IPAdapter模型权重文件路径 | 从下拉菜单选择 .safetensors 或 .pt 文件 |
| clip_vision | clip_vision | google/siglip-so400m-patch14-384 | 保持默认 | 选择图片理解工具，就像选择不同的眼镜来看图片 | 指定CLIP视觉编码器模型 | 通常保持默认选项即可 |
| provider | provider | cuda/cpu/mps | cuda（有显卡）或 cpu | 选择用什么设备来运行，就像选择用电脑还是手机 | 指定模型运行的计算设备 | 有NVIDIA显卡选cuda，Mac选mps，其他选cpu |
3.2 ApplyIPAdapterFlux 节点（应用节点）
这个节点是干嘛的？
这个节点是真正的"魔法师"，它把你的参考图片和 AI 模型结合起来，让 AI 在生成新图片时参考你提供的图片。就像给 AI 画家一张参考照片，告诉它"按照这个风格来画"。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| model | model | MODEL类型 | 连接你的AI模型 | 接收要修改的AI模型，就像选择要用哪个画家 | 输入的FLUX扩散模型 | 从模型加载器节点连接过来 |
| ipadapter_flux | ipadapter_flux | IP_ADAPTER_FLUX_INSTANTX | 连接加载器节点 | 接收准备好的工具箱，就像接收画笔和颜料 | IPAdapter模型实例 | 从IPAdapterFluxLoader节点连接 |
| image | image | IMAGE类型 | 连接你的参考图片 | 你想让AI参考的图片，就像给画家看的参考照片 | 输入的参考图像张量 | 从图片加载节点连接 |
| weight | weight | 0.0-5.0 | 1.0 | 控制参考图片的影响强度，就像调节音量大小 | IPAdapter的权重系数 | 1.0是正常强度，2.0是双倍影响，0.5是一半影响 |
| start_percent | start_percent | 0.0-1.0 | 0.0 | 从生成过程的什么时候开始参考图片，0是从头开始 | 开始应用IPAdapter的时间步百分比 | 0.0表示从一开始就参考，0.3表示从30%进度开始参考 |
| end_percent | end_percent | 0.0-1.0 | 1.0 | 到生成过程的什么时候停止参考图片，1是到最后 | 停止应用IPAdapter的时间步百分比 | 1.0表示参考到最后，0.7表示参考到70%就停止 |
3.3 IPAdapterFluxLoaderAdvanced 节点（高级加载器节点）
这个节点是干嘛的？
这是加载器节点的"升级版"，功能和普通加载器一样，但是为高级应用节点准备工具。就像普通工具箱和专业工具箱的区别，专业版有更多精细控制功能。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| ipadapter | ipadapter | 下拉选择模型文件 | 选择你下载的模型 | 选择要使用的图片适配器模型，就像选择不同的画笔 | 指定IPAdapter模型权重文件路径 | 从下拉菜单选择 .safetensors 或 .pt 文件 |
| clip_vision | clip_vision | google/siglip-so400m-patch14-384 | 保持默认 | 选择图片理解工具，就像选择不同的眼镜来看图片 | 指定CLIP视觉编码器模型 | 通常保持默认选项即可 |
| provider | provider | cuda/cpu/mps | cuda（有显卡）或 cpu | 选择用什么设备来运行，就像选择用电脑还是手机 | 指定模型运行的计算设备 | 有NVIDIA显卡选cuda，Mac选mps，其他选cpu |
3.4 ApplyIPAdapterFluxAdvanced 节点（高级应用节点）
这个节点是干嘛的？
这是应用节点的"专业版"，它不仅能让 AI 参考你的图片，还能精确控制参考强度的变化过程。就像一个专业调音师，可以让音乐在不同时间有不同的音量变化，而不是始终保持一个音量。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| model | model | MODEL类型 | 连接你的AI模型 | 接收要修改的AI模型，就像选择要用哪个画家 | 输入的FLUX扩散模型 | 从模型加载器节点连接过来 |
| ipadapter_flux | ipadapter_flux | IP_ADAPTER_FLUX_INSTANTX | 连接高级加载器 | 接收准备好的专业工具箱 | IPAdapter模型实例 | 从IPAdapterFluxLoaderAdvanced节点连接 |
| image | image | IMAGE类型 | 连接你的参考图片 | 你想让AI参考的图片，就像给画家看的参考照片 | 输入的参考图像张量 | 从图片加载节点连接 |
| weight_start | weight_start | -1.0-5.0 | 0.0 | 开始时的参考强度，就像音乐开始时的音量 | IPAdapter在开始时的权重系数 | 0.0表示开始时不参考，1.0表示开始时正常参考 |
| weight_end | weight_end | -1.0-5.0 | 1.0 | 结束时的参考强度，就像音乐结束时的音量 | IPAdapter在结束时的权重系数 | 1.0表示结束时正常参考，2.0表示结束时双倍参考 |
| steps | steps | 1-100 | 10 | 强度变化的步数，就像音量调节有多少个档位 | 权重变化的总步数 | 10表示分10步从开始强度变到结束强度 |
| start_percent | start_percent | 0.0-1.0 | 0.0 | 从生成过程的什么时候开始参考图片 | 开始应用IPAdapter的时间步百分比 | 0.0表示从一开始就参考，0.3表示从30%进度开始参考 |
| end_percent | end_percent | 0.0-1.0 | 1.0 | 到生成过程的什么时候停止参考图片 | 停止应用IPAdapter的时间步百分比 | 1.0表示参考到最后，0.7表示参考到70%就停止 |
4. 使用技巧和建议
4.1 选择合适的节点
- 新手用户：建议使用普通版本（IPAdapterFluxLoader + ApplyIPAdapterFlux）
- 高级用户：想要精细控制可以使用高级版本（IPAdapterFluxLoaderAdvanced + ApplyIPAdapterFluxAdvanced）
4.2 参数调节技巧
- weight（影响强度）：
- 0.5-0.8：轻微参考，保持原创性
- 1.0-1.5：正常参考，平衡效果
- 1.5-3.0：强烈参考，更像参考图
- 时间控制：
- start_percent=0.0, end_percent=1.0：全程参考
- start_percent=0.0, end_percent=0.5：前半段参考
- start_percent=0.5, end_percent=1.0：后半段参考
4.3 高级版本的权重变化
- 渐强效果：weight_start=0.0, weight_end=1.5
- 渐弱效果：weight_start=1.5, weight_end=0.0
- 先强后弱：weight_start=2.0, weight_end=0.5
4.4 多图片参考
- 可以使用多个 Apply 节点串联，实现多张图片同时参考
- 每张图片可以设置不同的权重和时间范围
5. 常见问题解答
Q1: 为什么加载模型时报错？
A: 检查以下几点：
- 确保模型文件下载完整
- 检查文件路径是否正确
- 确认 ComfyUI 版本是否支持（需要 commit bda1482 之后的版本）
Q2: 生成的图片和参考图差别太大怎么办？
A: 尝试以下调整：
- 增加 weight 值（比如从 1.0 调到 1.5）
- 检查参考图片质量，清晰度高的图片效果更好
- 确保提示词和参考图片风格匹配
Q3: 生成速度很慢怎么办？
A: 优化建议：
- 如果有 NVIDIA 显卡，确保 provider 设置为 "cuda"
- 检查显存是否足够，不够的话可以降低生成分辨率
- 关闭其他占用显存的程序
Q4: 高级版本的权重变化看不出效果？
A: 检查设置：
- 确保 weight_start 和 weight_end 有明显差异
- steps 数量不要太少，建议 10 以上
- 时间范围要合理，不要太短
Q5: 可以同时使用多个参考图片吗？
A: 可以的：
- 使用多个 Apply 节点串联
- 每个节点连接不同的参考图片
- 可以为每张图片设置不同的参数
6. 工作流示例
基础工作流
- 加载 FLUX 模型
- 连接 IPAdapterFluxLoader 节点
- 连接 ApplyIPAdapterFlux 节点
- 加载参考图片
- 设置提示词
- 开始生成
高级工作流
- 使用 IPAdapterFluxLoaderAdvanced
- 连接 ApplyIPAdapterFluxAdvanced
- 设置权重变化参数
- 调节时间控制参数
- 精细调节生成效果
7. 总结
这个插件为 ComfyUI 用户提供了强大的图片参考功能，让 AI 生成更加可控和精准。无论是新手还是高级用户，都能找到适合自己的使用方式。记住，多尝试不同的参数组合，找到最适合你需求的设置！
重要提醒：
- 确保 ComfyUI 版本足够新
- 下载完整的模型文件
- 根据自己的硬件选择合适的 provider
- 从简单参数开始，逐步尝试复杂功能
希望这个教程能帮助你更好地使用 ComfyUI-IPAdapter-Flux 插件！