LTXVGeneratedKeyframesToGuides - ComfyUI Built-in Node Documentation

The LTXV Generated Keyframes to Guides node pins generated keyframes from an earlier stage as frozen image guides on a later canvas. It decodes the keyframes as standalone frames, resizes them if needed, and writes them with a noise mask of 0 so they are not denoised again. After a temporal upscale, recorded indices are scaled from the canvas they were generated on onto this one; use override_frame_indices to set positions explicitly.

Inputs

Parameter	Description	Data Type	Required	Range
`positive`	Positive conditioning to add the keyframe guides to.	CONDITIONING	Yes
`negative`	Negative conditioning to add the keyframe guides to.	CONDITIONING	Yes
`vae`	The VAE used to decode the keyframes if resizing is needed.	VAE	Yes
`latent`	The target video latent to add the guides to, e.g. the temporally upscaled one.	LATENT	Yes
`keyframes`	The keyframes output of LTXV Separate Generated Keyframes, which carries the pixel frame index each keyframe was generated at.	LATENT	Yes
`strength`	Guide strength. 1.0 is a hard pin; lower values relax it. (default: 1.0)	FLOAT	Yes	0.0 - 10.0 (step 0.01)
`override_frame_indices`	Optional — pin at these pixel frames instead of the recorded (or auto-scaled) positions. Provide one index per keyframe. Leave empty to reuse recorded positions, or to scale them when the target canvas is a different length (e.g. after temporal x2). (default: "")	STRING	No

Outputs

Output Name	Description	Data Type
`positive`	Positive conditioning with the keyframes pinned as image guides.	CONDITIONING
`negative`	Negative conditioning with the keyframes pinned as image guides.	CONDITIONING
`latent`	Target video latent with the keyframes added as frozen guides.	LATENT

Notes

The keyframes input must be connected to the keyframes output of LTXV Separate Generated Keyframes. The node raises an error if the latent does not carry generated keyframe positions.
The positive and negative conditioning inputs must come from the positive and negative outputs of LTXV Separate Generated Keyframes. The node raises an error if the positive conditioning still carries generated keyframes.
The latent input must be a plain video latent (5D tensor). Guides must be added before merging the video and audio latents with Concat AV Latent.
Only a batch size of 1 is supported. Each guide is encoded from one image, so it cannot differ across batch elements.
The number of keyframes in the keyframes latent must match the number of recorded positions; otherwise an error is raised.
If override_frame_indices is left empty, recorded positions are used. If the target canvas has a different number of frames than the canvas the keyframes were generated on, the recorded indices are scaled automatically.
If override_frame_indices is provided, it must contain one integer index per keyframe, separated by commas or spaces. Indices must be unique and lie between 1 and (number of pixel frames in the target latent - 1). Otherwise an error is raised.
If any final keyframe index is greater than or equal to the number of pixel frames in the target latent, the node raises an error. This can happen when the target was resized temporally after the keyframes were generated.
The strength parameter has a minimum of 0.0 and a maximum of 10.0.

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): b5dbf302fad5a7ffd3522d468d1a51b993145d90277592058315499f08e17e7b

​Inputs

​Outputs

​Notes

Inputs

Outputs

Notes