ComfyUI Node: LTX25 Reference Params

LTX25 Reference Params:

The LTX25ReferenceParams node is designed to encode reference stills into LTX2.5 guide latents, which are essential for the LTX25 Ultimate Upscale process. This node plays a crucial role in maintaining identity and scene consistency across independently sampled chunks by converting each batch item into a reference guide latent. These guides are then used to pin down the identity and scene elements, ensuring that the upscaled output remains true to the original reference images. Additionally, the node can integrate with the MSR IC-LoRA Loader to utilize slot embeddings and offsets, enhancing the flexibility and precision of the upscaling process. This capability is particularly beneficial for artists looking to upscale images while preserving the original scene's integrity and details.

LTX25 Reference Params Input Parameters:

iclora_parameters

This optional input parameter allows you to connect IC-LoRA parameters from a Get IC-LoRA Parameters node. It is used to adjust guide processing as required by certain IC-LoRAs, especially those with a reference_downscale_factor greater than 1. When connected, each LTXVAddGuide uses only the parameters linked to it, providing a tailored approach to guide processing. This parameter does not have specific minimum, maximum, or default values, as it depends on the IC-LoRA configuration being used.

LTX25 Reference Params Output Parameters:

reference_guides

The output parameter reference_guides provides the encoded reference stills as guide tokens. These tokens are appended to every chunk as near-clean guide tokens using the native LTXVAddGuide mechanism. This output is crucial for maintaining identity and scene consistency across independently sampled chunks, ensuring that the upscaled images remain faithful to the original references.

LTX25 Reference Params Usage Tips:

• To achieve optimal results, ensure that your reference stills are of high quality and accurately represent the scene or identity you wish to maintain during upscaling.
• When using the MSR IC-LoRA Loader, connect its output to leverage slot embeddings and offsets, which can enhance the precision of the guide latents.

LTX25 Reference Params Common Errors and Solutions:

MissingReferenceGuidesError

• Explanation: This error occurs when the reference_guides output is not connected, leading to a lack of guide tokens for the upscaling process.
• Solution: Ensure that the reference_guides output is properly connected to the main node's reference_guides input to provide the necessary guide tokens.

InvalidICLoRAParametersError

• Explanation: This error arises when the iclora_parameters input is connected with incompatible or incorrect IC-LoRA parameters.
• Solution: Verify that the IC-LoRA parameters are correctly configured and compatible with the node's requirements. Adjust the parameters as needed to ensure proper guide processing.