ComfyUI Node
Reference Latent+
A ComfyUI node in advanced/conditioning with 56 inputs and 1 output.
Reference Latent+
- conditioning
- vae
- image_1
- image_2
- image_3
- image_4
- mask_1
- mask_2
- mask_3
- mask_4
- conditioning
◄max_megapixels1.0►
◄mask_fill_modepixel_grey►
◄image1_strength0.85►
◄image1_facefalse►
◄image1_hairfalse►
◄image1_bodyfalse►
◄image1_clothesfalse►
◄image1_backgroundfalse►
◄image1_ignore_areanone►
◄image1_feather0►
◄image1_grow0►
◄image1_start_percent0.000►
◄image1_end_percent1.000►
◄image2_strength0.85►
◄image2_facefalse►
◄image2_hairfalse►
◄image2_bodyfalse►
◄image2_clothesfalse►
◄image2_backgroundfalse►
◄image2_ignore_areanone►
◄image2_feather0►
◄image2_grow0►
◄image2_start_percent0.000►
◄image2_end_percent1.000►
◄image3_strength0.85►
◄image3_facefalse►
◄image3_hairfalse►
◄image3_bodyfalse►
◄image3_clothesfalse►
◄image3_backgroundfalse►
◄image3_ignore_areanone►
◄image3_feather0►
◄image3_grow0►
◄image3_start_percent0.000►
◄image3_end_percent1.000►
◄image4_strength0.85►
◄image4_facefalse►
◄image4_hairfalse►
◄image4_bodyfalse►
◄image4_clothesfalse►
◄image4_backgroundfalse►
◄image4_ignore_areanone►
◄image4_feather0►
◄image4_grow0►
◄image4_start_percent0.000►
◄image4_end_percent1.000►
Categoryadvanced/conditioning
Inputs (56)
| Name | Type | Default | Description |
|---|---|---|---|
| conditioning | CONDITIONING | — | |
| vae | VAE | — | |
| image_1 | IMAGE | — | |
| max_megapixels | FLOAT | 1.00.1–4 | Caps each ref image by area. Downscales only — small images pass through. Lower = faster (fewer attention tokens). |
| mask_fill_mode | COMBO | pixel_grey | How masked-out regions are neutralised before the model attends to the ref. pixel_grey: replace masked pixels with 0.5 grey before VAE encode. In-distribution; the masked latent has soft uniform signal. latent_zero: encode full image, then zero the latent at masked positions. Constant K/V at those tokens (= layer bias) so attention distributes uniformly over them. Spiritual equivalent of 'transparent'. latent_noise: same as latent_zero but fills with Gaussian noise instead of zeros. Different attention shape — random K/V means no Q matches strongly, model weakly ignores those tokens. |
| image_2opt | IMAGE | — | |
| image_3opt | IMAGE | — | |
| image_4opt | IMAGE | — | |
| mask_1opt | MASK | Optional explicit mask for image 1. Overrides this image's auto-mask config below. | |
| mask_2opt | MASK | Optional explicit mask for image 2 (overrides auto-mask). | |
| mask_3opt | MASK | Optional explicit mask for image 3 (overrides auto-mask). | |
| mask_4opt | MASK | Optional explicit mask for image 4 (overrides auto-mask). | |
| image1_strengthopt | FLOAT | 0.85-5–50 | Per-image strength (signed). 1.0 = stock ReferenceLatent strength. 0.85 = empirical sweet spot. 0 = bypass this image entirely. Negative = anti-reference (model pulled away from this ref's features). |
| image1_faceopt | BOOLEAN | false | Face skin |
| image1_hairopt | BOOLEAN | false | Hair |
| image1_bodyopt | BOOLEAN | false | Body skin |
| image1_clothesopt | BOOLEAN | false | Clothes |
| image1_backgroundopt | BOOLEAN | false | Background (tick to use the background only — handy for environment refs) |
| image1_ignore_areaopt | COMBO | none | Exclude a side strip from the auto-mask. Useful when multiple subjects are in frame. |
| image1_featheropt | INT | 00–200 | Soften mask edges by N pixels (0 = sharp). 10-30 is usually enough. |
| image1_growopt | INT | 0-200–200 | Grow (>0) or shrink (<0) the mask by N pixels. Useful for tucking or extending the masked area beyond what MediaPipe detected. |
| image1_start_percentopt | FLOAT | 0.0000–1 | Fraction of denoising at which this image's ref starts applying. 0 = active from the very first step. |
| image1_end_percentopt | FLOAT | 1.0000–1 | Fraction of denoising at which this image's ref stops applying. 1 = active through the last step. For Flux2/Klein 9B, style/identity signal concentrates at the clean end of denoising — try start=0.6, end=1.0 to apply the ref only at the late (clean) timesteps and let the noisy/early timesteps freely follow your prompt's composition. |
| image2_strengthopt | FLOAT | 0.85-5–50 | Per-image strength (signed). 1.0 = stock ReferenceLatent strength. 0.85 = empirical sweet spot. 0 = bypass this image entirely. Negative = anti-reference (model pulled away from this ref's features). |
| image2_faceopt | BOOLEAN | false | Face skin |
| image2_hairopt | BOOLEAN | false | Hair |
| image2_bodyopt | BOOLEAN | false | Body skin |
| image2_clothesopt | BOOLEAN | false | Clothes |
| image2_backgroundopt | BOOLEAN | false | Background (tick to use the background only — handy for environment refs) |
| image2_ignore_areaopt | COMBO | none | Exclude a side strip from the auto-mask. Useful when multiple subjects are in frame. |
| image2_featheropt | INT | 00–200 | Soften mask edges by N pixels (0 = sharp). 10-30 is usually enough. |
| image2_growopt | INT | 0-200–200 | Grow (>0) or shrink (<0) the mask by N pixels. Useful for tucking or extending the masked area beyond what MediaPipe detected. |
| image2_start_percentopt | FLOAT | 0.0000–1 | Fraction of denoising at which this image's ref starts applying. 0 = active from the very first step. |
| image2_end_percentopt | FLOAT | 1.0000–1 | Fraction of denoising at which this image's ref stops applying. 1 = active through the last step. For Flux2/Klein 9B, style/identity signal concentrates at the clean end of denoising — try start=0.6, end=1.0 to apply the ref only at the late (clean) timesteps and let the noisy/early timesteps freely follow your prompt's composition. |
| image3_strengthopt | FLOAT | 0.85-5–50 | Per-image strength (signed). 1.0 = stock ReferenceLatent strength. 0.85 = empirical sweet spot. 0 = bypass this image entirely. Negative = anti-reference (model pulled away from this ref's features). |
| image3_faceopt | BOOLEAN | false | Face skin |
| image3_hairopt | BOOLEAN | false | Hair |
| image3_bodyopt | BOOLEAN | false | Body skin |
| image3_clothesopt | BOOLEAN | false | Clothes |
| image3_backgroundopt | BOOLEAN | false | Background (tick to use the background only — handy for environment refs) |
| image3_ignore_areaopt | COMBO | none | Exclude a side strip from the auto-mask. Useful when multiple subjects are in frame. |
| image3_featheropt | INT | 00–200 | Soften mask edges by N pixels (0 = sharp). 10-30 is usually enough. |
| image3_growopt | INT | 0-200–200 | Grow (>0) or shrink (<0) the mask by N pixels. Useful for tucking or extending the masked area beyond what MediaPipe detected. |
| image3_start_percentopt | FLOAT | 0.0000–1 | Fraction of denoising at which this image's ref starts applying. 0 = active from the very first step. |
| image3_end_percentopt | FLOAT | 1.0000–1 | Fraction of denoising at which this image's ref stops applying. 1 = active through the last step. For Flux2/Klein 9B, style/identity signal concentrates at the clean end of denoising — try start=0.6, end=1.0 to apply the ref only at the late (clean) timesteps and let the noisy/early timesteps freely follow your prompt's composition. |
| image4_strengthopt | FLOAT | 0.85-5–50 | Per-image strength (signed). 1.0 = stock ReferenceLatent strength. 0.85 = empirical sweet spot. 0 = bypass this image entirely. Negative = anti-reference (model pulled away from this ref's features). |
| image4_faceopt | BOOLEAN | false | Face skin |
| image4_hairopt | BOOLEAN | false | Hair |
| image4_bodyopt | BOOLEAN | false | Body skin |
| image4_clothesopt | BOOLEAN | false | Clothes |
| image4_backgroundopt | BOOLEAN | false | Background (tick to use the background only — handy for environment refs) |
| image4_ignore_areaopt | COMBO | none | Exclude a side strip from the auto-mask. Useful when multiple subjects are in frame. |
| image4_featheropt | INT | 00–200 | Soften mask edges by N pixels (0 = sharp). 10-30 is usually enough. |
| image4_growopt | INT | 0-200–200 | Grow (>0) or shrink (<0) the mask by N pixels. Useful for tucking or extending the masked area beyond what MediaPipe detected. |
| image4_start_percentopt | FLOAT | 0.0000–1 | Fraction of denoising at which this image's ref starts applying. 0 = active from the very first step. |
| image4_end_percentopt | FLOAT | 1.0000–1 | Fraction of denoising at which this image's ref stops applying. 1 = active through the last step. For Flux2/Klein 9B, style/identity signal concentrates at the clean end of denoising — try start=0.6, end=1.0 to apply the ref only at the late (clean) timesteps and let the noisy/early timesteps freely follow your prompt's composition. |
Outputs (1)
| Name | Type | Description |
|---|---|---|
| conditioning | CONDITIONING | — |