IPAdapter Plus 节点参考：预设、视觉编码器与 FaceID 依赖关系
固定版本源码表明 IPAdapterUnifiedLoader 用 MODEL 和预设加载资源，输出 MODEL 与 IPADAPTER；参考图片接在后续应用节点。
用途与适用范围
IPAdapterUnifiedLoader 将底模 MODEL 与适配器预设配套，返回 MODEL 和 IPADAPTER 管线；它本身不接收或编码参考图片。实际安装版本仍应以运行中的节点定义为准。
已核对的依据
作者 README 区分统一加载器要求的精确文件名与手动选择文件，并说明 IPAdapter、CLIP Vision、FaceID 及 LoRA 的配套。在固定版本源码中，IPAdapterUnifiedLoader 必需输入为 model 和 preset，可选 ipadapter，输出为 MODEL 与 IPADAPTER；FaceID 预设属于单独的 IPAdapterUnifiedLoaderFaceID 类，另有 lora_strength 和 provider 输入。这是该固定源码的静态事实，不保证所有已安装版本完全相同。作者 README 固定版本加载器源码
开始前需要分清的事项
1. 普通图像参考路径：底模、视觉编码器与 IPAdapter 变体需要匹配。
2. FaceID 使用单独的统一加载器，还需对应 InsightFace 环境；多数变体还要匹配的 LoRA。
3. 旧教程与新统一预设可能使用不同节点，不能只照着界面外观替换。
操作与检查步骤
以下步骤是基于所列资料编排的操作建议；具体文件、版本和运行环境仍需按实际项目核对。
第 1 步。 先确定参考目的和底模家族，从作者 examples 选择对应最小流程。
第 2 步。 普通统一加载器提供 model 与受支持的 preset，也可接入已有 ipadapter 管线；按 README 的精确文件名准备对应资源。手动加载器需显式选择文件，FaceID 预设则使用独立的 FaceID 加载器。
第 3 步。 将返回的 MODEL 和 IPADAPTER 管线接到兼容的应用节点，参考图片在那里连接；先追踪所选 CLIP Vision 与适配器文件，再固定输入比较生成结果。
第 4 步。 把报错分到模型未找到、视觉编码器、InsightFace、版本冲突等具体页面，避免在一个大段落里混用全部修复。
完成后的检查
所选预设能解析到对应的 CLIP Vision 和适配器资源，且当前服务端显示预期的加载器输入及 MODEL/IPADAPTER 输出；实际图像引导仍需兼容应用路径和运行验证。
注意事项与尚未确认的部分
作者将该仓库标为 maintenance-only。这里仅静态核对固定源码中的 IPAdapterUnifiedLoader，不是运行中 /object_info 的导出，也不是整个包的完整接口清单；本站不重新分发参考素材或权重。
资料及中文语言审查日期：2026-09-26。这里只静态阅读固定版本源码；本站未运行 IPAdapter、加载模型或进行 GPU 测试。
原始资料
- R01 · ComfyUI IPAdapter Plus README。核对：2026-09-26。
- 固定版本 IPAdapterUnifiedLoader 源码。核对：2026-09-26。
相关排查与操作
IPAdapterUnifiedLoader
必需：model (MODEL) 与 preset（固定源码有六个选项，包括 LIGHT、STANDARD、VIT-G、PLUS 和面部取向变体）。 + 可选：ipadapter (IPADAPTER 管线)。FaceID 预设属于独立的 IPAdapterUnifiedLoaderFaceID，另有 lora_strength 和 provider 输入。 + 静态依据为 a0f451a；实际安装版本请查 /object_info/IPAdapterUnifiedLoader。 → MODEL：此加载器返回的模型。独立的 FaceID 加载器可按其设置叠加对应 LoRA。 + IPADAPTER：包含 CLIP Vision、适配器与 InsightFace 槽位的管线，交给后续应用节点。ComfyUI_IPAdapter_plus
接口参考摘要；必选/可选输入、默认值与版本请以对应上游来源为准。
这篇内容对你有帮助吗？
匿名统计，只记录“有/没有帮助”的计数，不记录账号、IP 地址或设备信息。
资料来源
2026-09-26 复核作者 README 和固定版本 a0f451a 的 IPAdapterPlus.py，仅确认普通统一加载器的静态接口。没有完整包清单、动态 /object_info、模型加载或 GPU 测试。
01ComfyUI IPAdapter Plus README资料核对: 2026-09-2602Pinned IPAdapterUnifiedLoader source资料核对: 2026-09-26报告问题 · 6c83a5d7-1da5-54e7-944a-29a17b071fec
相关阅读
编辑为本页关联的条目。
日志关键词: IPAdapter model not found.
已下载 IPAdapter 权重，但统一加载器仍无法自动选择文件。首先检查所用加载器的规则；“文件在磁盘上”与“能够按预设自动找到”并不是一回事。
日志关键词: ClipVision model not found.
参考图工作流缺少视觉编码器，或加载后在图像嵌入阶段出现维度不匹配。先确认需要的是 CLIP Vision，而不是 CLIPTextEncode 对应的文本编码器。
日志关键词: No module named 'insightface'
使用 FaceID 时出现 insightface 模块缺失、构建 wheel 失败，或者包安装后仍无法初始化。这里需要分别确认解释器、二进制构建、运行后端与模型资源。