Nodes/ComfyUI_IPAdapter_plus_V2/IPAdapter Tiled Batch V2
ComfyUI Node

IPAdapter Tiled Batch V2

Tiled detail for a whole sequence of references

By chflame163·Created 2 years ago·Updated 2 years ago· 55
IPAdapter Tiled Batch V2
  • model
  • ipadapter
  • image
  • image_negative
  • attn_mask
  • clip_vision
  • MODEL
  • tiles
  • masks
weight1.00
weight_type
start_at0.000
end_at1.000
sharpening0.00
embeds_scaling
encode_batch_size0

The batch version of IPAdapterTiledV2 - same tiling trick, but built for when your image input is a sequence of references rather than a single picture. It slices each reference into 256px tiles, conditions the model on each tile with its own attention mask, and treats every image in the batch as its own tiling job. If you're animating with IP-Adapter and your reference frames carry detail you care about, this is the node; the single-image version would fold the whole batch into one conditioning and blur the very detail you tiled to preserve.

Mechanically it's the tiled pipeline with unfold_batch = True: each image in the batch gets encoded, tiled, and conditioned separately instead of being merged into a single average conditioning. On top of that it adds one input the non-batch tiled node doesn't have: encode_batch_size (0–4096, default 0). That's the memory-batching control - it caps how many tile-encodes run at once, so on a tight-VRAM card you can set it to something small like 2 or 4 and trade a little speed for not OOM-ing. 0 means "let it run all at once."

The inputs that matter:

  • image - a batch of reference images. Match this to however many frames your latent batch uses.
  • weight, weight_type, start_at, end_at - the standard influence controls
  • sharpening (default 0) - contrast-adaptive sharpening per tile; the detail-recovery dial
  • embeds_scaling - injection mode for the tile embeddings
  • encode_batch_size - the VRAM limiter mentioned above

Outputs: MODEL, plus tiles and masks (the extracted tile images and their attention masks) so you can preview exactly what each frame is conditioning on.

When you'd reach for it

Frame-accurate detail in animation: each frame of a sequence carries its own high-detail reference, and you want each frame conditioned on its own tiles. Also the honest default for anyone whose still-image tiled runs are fine but whose batch runs stutter - the encode_batch_size knob is exactly the escape hatch for that.

Install

Part of chflame163/ComfyUI_IPAdapter_plus_V2, the V2 fork of cubiq's pack. Manager → search ComfyUI_IPAdapter_plus_V2, or:

cd ComfyUI/custom_nodes
git clone https://github.com/chflame163/ComfyUI_IPAdapter_plus_V2

Restart. No pip requirements.

Gotchas

Batch length is the classic failure: the reference batch needs to line up with your frame count, and a mismatch silently means some frames get conditioned by the wrong tile-set or skipped. The tile cap (max 4 tiles, with a hard center-crop beyond 4:1 aspect) applies per frame - a panorama in a batch gets its edges thrown away just like the single version does. And per-frame tiling is the most compute-hungry node in this pack; on a 6GB card set encode_batch_size low before it crashes, not after. The KB's general advice still applies: IP-Adapter across all steps softens detail, so keep end_at below 1.0 when you care about sharpness.

Categoryipadapter/tiled

Inputs (13)

NameTypeDefaultDescription
modelMODEL
ipadapterIPADAPTER
imageIMAGE
weightFLOAT1.00-1–3
weight_typeCOMBO15 options: linear, ease in, ease out, ease in-out, reverse in-out, weak input, +9
start_atFLOAT0.0000–1
end_atFLOAT1.0000–1
sharpeningFLOAT0.000–1
embeds_scalingCOMBO4 options: V only, K+V, K+V w/ C penalty, K+mean(V) w/ C penalty
encode_batch_sizeINT00–4096
image_negativeoptIMAGE
attn_maskoptMASK
clip_visionoptCLIP_VISION

Outputs (3)

NameTypeDescription
MODELMODEL
tilesIMAGE
masksMASK