Inputs
| Parameter | Description | Data Type | Required | Range |
|---|---|---|---|---|
positive | Positive conditioning input to be modified with keyframe guidance | CONDITIONING | Yes | - |
negative | Negative conditioning input to be modified with keyframe guidance | CONDITIONING | Yes | - |
vae | VAE model used for encoding the input image/video frames | VAE | Yes | - |
latent | Input latent sequence that will receive the conditioning frames | LATENT | Yes | - |
image | Image or video to condition the latent video on. Must be 8n + 1 frames. If the video is not 8n + 1 frames, it will be cropped to the nearest 8*n + 1 frames. | IMAGE | Yes | - |
frame_idx | Frame index to start the conditioning at. For single-frame images or videos with 1-8 frames, any frame_idx value is acceptable. For videos with 9+ frames, frame_idx must be divisible by 8, otherwise it will be rounded down to the nearest multiple of 8. Negative values are counted from the end of the video. (default: 0) | INT | No | -9999 to 9999 |
strength | Strength of the conditioning influence, where 1.0 applies full conditioning and 0.0 applies no conditioning (default: 1.0) | FLOAT | No | 0.0 to 10.0 |
attention_mask | Optional pixel-space spatial mask. Controls per-region conditioning influence via self-attention, multiplied by strength. | MASK | No | - |
iclora_parameters | Optional IC-LoRA parameters from a Get IC-LoRA Parameters node. Used for adjusting guide processing as required by certain IC-LoRAs (e.g., those with a reference_downscale_factor > 1). When chained, each LTXVAddGuide uses only the parameters connected to it. | IC_LORA_PARAMETERS | No | - |
iclora_parameters: When using IC-LoRA parameters with a reference_downscale_factor greater than 1, the latent spatial dimensions (width and height) must be divisible by that factor. The node will raise an error if this condition is not met.
Outputs
| Output Name | Description | Data Type |
|---|---|---|
positive | Positive conditioning updated with keyframe guidance information | CONDITIONING |
negative | Negative conditioning updated with keyframe guidance information | CONDITIONING |
latent | Latent sequence with incorporated conditioning frames and updated noise mask | LATENT |
This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! Edit on GitHub
Source fingerprint (SHA-256):
889348768112c6ecc3ef2e724981d3c49d96339b156617725816cf4186a94b7a