IPAdapter Combine Params
Stack several masked references into one pass
- 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_1andparams_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 theipadapter_paramsinput 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.
Inputs (5)
| Name | Type | Default | Description |
|---|---|---|---|
| params_1 | IPADAPTER_PARAMS | — | |
| params_2 | IPADAPTER_PARAMS | — | |
| params_3opt | IPADAPTER_PARAMS | — | |
| params_4opt | IPADAPTER_PARAMS | — | |
| params_5opt | IPADAPTER_PARAMS | — |
Outputs (1)
| Name | Type | Description |
|---|---|---|
| IPADAPTER_PARAMS | IPADAPTER_PARAMS | — |