IPAdapter Plus reference: presets, vision encoders and FaceID dependencies

Pinned source defines IPAdapterUnifiedLoader as a MODEL and preset loader that returns MODEL plus IPADAPTER; the reference image enters a later apply node.

Updated 2026-09-25Published revision: 7Source baseline: not recorded

Purpose and scope

IPAdapterUnifiedLoader pairs a base MODEL with an adapter preset and returns a MODEL plus an IPADAPTER pipeline. It does not take or encode a reference image by itself; check the running node definition for version differences.

Source-supported context

The author's README distinguishes exact filenames for unified loading from manually selected files and documents IPAdapter, CLIP Vision, FaceID and LoRA pairings. In pinned source, IPAdapterUnifiedLoader declares required model and preset, optional ipadapter, and returns MODEL plus IPADAPTER. FaceID presets belong to a separate IPAdapterUnifiedLoaderFaceID class with additional lora_strength and provider inputs. These are static source facts for this pinned version, not a guarantee for every installed version. README Pinned loader source

Before you start

1. Ordinary image guidance needs a compatible base, vision encoder and adapter variant.

2. FaceID uses a separate unified loader and needs its InsightFace environment; most FaceID variants also require their matching LoRA.

3. Older examples and unified presets may use different classes rather than visually interchangeable controls.

Steps and checks

The sequence below is an editorial procedure based on the cited context, not a diagnosis already confirmed for your environment.

Step 1. Choose the reference purpose and base family, then find the author's matching minimal example.

Step 2. For the ordinary unified loader, provide model and a supported preset, plus an optional existing ipadapter pipeline. Use the README's exact filenames for that preset; manual loaders select files explicitly. Use the separate FaceID loader for FaceID presets.

Step 3. Pass the returned MODEL and IPADAPTER pipeline to a compatible apply node and connect the reference image there. Trace the chosen CLIP Vision and adapter files before comparing output with fixed inputs.

Step 4. Send missing weights, vision-encoder, InsightFace and version errors to their specific guides instead of mixing all repairs in one paragraph.

Completion check

The selected preset resolves its CLIP Vision and adapter resources; the running server reports the expected loader inputs and MODEL/IPADAPTER outputs. Actual image guidance still requires a compatible apply path and a run.

Limitations and cautions

The author marks the package maintenance-only. This static interface covers only IPAdapterUnifiedLoader at the pinned source commit; it is not a runtime /object_info dump or a complete package inventory. No reference media or weights are redistributed.

Original sources

ComfyUI IPAdapter Plus README — checked 2026-09-26.
Pinned IPAdapterUnifiedLoader source — checked 2026-09-26.

Source and English-language review: 2026-09-26. The interface is a static reading of the pinned source; no IPAdapter execution, model load or GPU test was run.

IPAdapterUnifiedLoader

Required: model (MODEL) and preset (six choices in pinned source, including LIGHT, STANDARD, VIT-G, PLUS and face-oriented variants). + Optional: ipadapter (IPADAPTER pipeline). FaceID presets use the separate IPAdapterUnifiedLoaderFaceID class with lora_strength and provider inputs. + Static source at a0f451a; verify the actual installed schema with /object_info/IPAdapterUnifiedLoader. → MODEL: the model returned by this loader. The separate FaceID loader can apply a matching LoRA according to its settings. + IPADAPTER: a pipeline containing CLIP Vision, adapter and InsightFace slots for a downstream apply node.

ComfyUI_IPAdapter_plus

Reference interface summary; confirm required/optional inputs, defaults and version in the upstream source.

Was this page helpful?

Anonymous. Only a yes/no counter is stored; no account, IP address or device details.

Sources & references

2026-09-26 reviewed current author README and pinned a0f451a IPAdapterPlus.py for the specific unified-loader interface. No full-package inventory, dynamic /object_info response, model load or GPU test is claimed.

01ComfyUI IPAdapter Plus READMESource checked: 2026-09-26 02Pinned IPAdapterUnifiedLoader sourceSource checked: 2026-09-26