Nodes/ComfyUI_IPAdapter_plus/IPAdapter Combine Params
ComfyUI Node Runs on cloud

IPAdapter Combine Params

Stack several masked references into one pass

By cubiq·Created 3 years ago·Updated about a year ago· 6,086
IPAdapter Combine Params
  • params_1
  • params_2
  • params_3
  • params_4
  • params_5
  • IPADAPTER_PARAMS

This is a plumbing node, and it only makes sense as half of a pair. IPAdapter has a "params" workflow for applying multiple references in a single pass - each with its own image, weight, and attention mask - which is how you do regional IPAdapter (this reference in the top-left, that one on the right, another over here). Combine Params is the node that merges those separate parameter bundles into one. Its output then goes into IPAdapter From Params, which does the actual applying.

You'd reach for it when you're building a regional or multi-subject composition and you've got two or more IPAdapter encoders each set up with their own reference and mask. Rather than chaining a dozen apply nodes in series (which works but gets slow and messy), the params approach bundles them and applies them together. Combine Params is the funnel.

How it works

There's nothing to configure here - no weights, no images, no enums. It takes IPADAPTER_PARAMS inputs and outputs a single, merged IPADAPTER_PARAMS. Each of those param bundles is produced upstream by an IPAdapter encoder/params node that already holds a reference image, a weight, and (usually) a mask. Combine Params just concatenates them so they can be handed off as one object.

The inputs and output

  • params_1 and params_2 - required. The first two parameter bundles.
  • params_3, params_4, params_5 - optional. Three more slots, so you can merge up to five references in one node.
  • Output: IPADAPTER_PARAMS - the combined bundle. This wires into the ipadapter_params input of IPAdapter From Params, which is where the merged references actually get applied to your model.

That's the entire surface. It's a connector, not a control panel.

Installing the pack

ComfyUI Manager: search ComfyUI IPAdapter plus, install, restart. Manual:

cd ComfyUI/custom_nodes
git clone https://github.com/cubiq/ComfyUI_IPAdapter_plus

then restart ComfyUI, and keep Comfy itself current - this pack is fussy about running on the latest version. The params nodes themselves don't need extra files, but the encoders and apply nodes around them need the usual CLIP vision encoders in ComfyUI/models/clip_vision and IPAdapter weights in ComfyUI/models/ipadapter.

Where people get burned

The trap that catches everyone with the params workflow: every bundle you combine has to be built against the same base model and the same IPAdapter model. Combine Params doesn't validate that for you - it'll happily merge mismatched bundles, and then From Params falls over downstream with an error that points at the wrong place. If a params chain errors out, walk back and confirm all the encoders feeding it were set up consistently.

The other thing to know is when not to bother. If you only have one reference, you don't need the params system at all - use a normal IPAdapter apply node. The params route only earns its complexity when you're genuinely applying several masked references in one shot. And as with the whole pack: this is SD 1.5 / SDXL territory, maintenance-only now, nothing for Flux.

Categoryipadapter/params

Inputs (5)

NameTypeDefaultDescription
params_1IPADAPTER_PARAMS
params_2IPADAPTER_PARAMS
params_3optIPADAPTER_PARAMS
params_4optIPADAPTER_PARAMS
params_5optIPADAPTER_PARAMS

Outputs (1)

NameTypeDescription
IPADAPTER_PARAMSIPADAPTER_PARAMS