ComfyUI Node
LTX Multi Reference Slots
Attaches up to six reference images as separate reference blocks, each with its own source id and, when the LoRA carries one, its trained slot embedding. Pair with LTX Reference Tags so the prompt names the slots the way training did.
LTX Multi Reference Slots
- model
- positive
- negative
- vae
- latent
- reference_1
- reference_2
- reference_3
- reference_4
- reference_5
- reference_6
- references
- model
- positive
- negative
- latent
- info
◄slot_embedding_loranone►
◄start_source_id1►
◄phase_scale1.0►
◄slot_strength1.00►
◄layoutoverlap►
◄ref_resize_modematch_target_letterbox►
◄reference_temporal_offset_latents0►
CategoryBFS/LTX
Inputs (19)
| Name | Type | Default | Description |
|---|---|---|---|
| model | MODEL | — | |
| positive | CONDITIONING | — | |
| negative | CONDITIONING | — | |
| vae | VAE | — | |
| latent | LATENT | — | |
| reference_1opt | IMAGE | Reference image for slot 1 — the subject your prompt calls <Image 1>. Leave unconnected to skip; connected slots are numbered in order, so wiring 1 and 3 gives them source ids 1 and 2. | |
| reference_2opt | IMAGE | Reference image for slot 2 — the subject your prompt calls <Image 2>. Leave unconnected to skip; connected slots are numbered in order, so wiring 1 and 3 gives them source ids 1 and 2. | |
| reference_3opt | IMAGE | Reference image for slot 3 — the subject your prompt calls <Image 3>. Leave unconnected to skip; connected slots are numbered in order, so wiring 1 and 3 gives them source ids 1 and 2. | |
| reference_4opt | IMAGE | Reference image for slot 4 — the subject your prompt calls <Image 4>. Leave unconnected to skip; connected slots are numbered in order, so wiring 1 and 3 gives them source ids 1 and 2. | |
| reference_5opt | IMAGE | Reference image for slot 5 — the subject your prompt calls <Image 5>. Leave unconnected to skip; connected slots are numbered in order, so wiring 1 and 3 gives them source ids 1 and 2. | |
| reference_6opt | IMAGE | Reference image for slot 6 — the subject your prompt calls <Image 6>. Leave unconnected to skip; connected slots are numbered in order, so wiring 1 and 3 gives them source ids 1 and 2. | |
| referencesopt | LTX_REFS | Output of LTX Reference Images. Use this OR the individual reference_N slots below — the list wins if both are connected. | |
| slot_embedding_loraopt | COMBO | none | The LoRA file to read the trained slot embedding from. Point this at the SAME LoRA you load for sampling. ComfyUI's LoRA loader applies only LoRA weights and drops the slot embedding, so without this the references are untagged and the checkpoint is sampled without a signal it was trained on. 'none' = phase separation only (older checkpoints). |
| start_source_idopt | INT | 10–8 | Source id of the first connected reference; the rest count up. The target is always 0. Start at 1 unless the checkpoint was trained otherwise. |
| phase_scaleopt | FLOAT | 1.00–4 | — |
| slot_strengthopt | FLOAT | 1.000–4 | Scales the learned slot tag. The tag and the adapter were trained together at strength 1.0, so raising the LoRA on the loader without raising this leaves them out of proportion — the adapter shouts while the tag that tells the references apart stays quiet. Match this to the LoRA strength you set on the loader (an undertrained LoRA often wants 1.2-1.5, and the tag wants the same). |
| layoutopt | COMBO | overlap | Where the references sit in the RoPE grid. Must match training. |
| ref_resize_modeopt | COMBO | match_target_letterbox | Letterbox is the safe default for subject references: it keeps the whole image, where match_target centre-crops and can cut a subject in half when the aspect ratios differ. |
| reference_temporal_offset_latentsopt | INT | 0-8–8 | — |
Outputs (5)
| Name | Type | Description |
|---|---|---|
| model | MODEL | — |
| positive | CONDITIONING | — |
| negative | CONDITIONING | — |
| latent | LATENT | — |
| info | STRING | — |