LTXVAddGeneratedKeyframes - ComfyUI Built-in Node Documentation - ComfyUI

LTXV Add Generated Keyframes 节点将细节关键帧追加到视频 latent。每个关键帧是一个由 token 组成的 latent 帧，位于单个像素帧之上；它会与视频一起被去噪，并且不属于解码输出的一部分。放置方式为每隔 interval_frames 个像素一个槽位，跳过 I2V 帧、现有引导，以及已经附加在条件上的生成关键帧；可使用 LTXV Separate Generated Keyframes 将它们取出。需要一个针对生成关键帧训练的 checkpoint（即带有 keyframes_abs_pos_embedding 的 checkpoint）。

输入

参数	描述	数据类型	必需	范围
`positive`	关键帧附加到的正向条件。	CONDITIONING	是	N/A
`negative`	关键帧附加到的负向条件。	CONDITIONING	是	N/A
`vae`	仅用于读取 latent 缩放因子。	VAE	是	N/A
`latent`	普通的 5D 视频 latent，用于伴随生成关键帧。请在 Concat AV Latent 之前添加它们。	LATENT	是	N/A
`interval_frames`	自动放置的像素帧步长。默认 24 在 24 fps 下约为每秒一个关键帧。已占用的像素会被跳过。设置 `frame_indices` 时忽略。（默认：24）	INT	否	1-1024
`keyframes`	用于初始化新关键帧的可选内容。连接来自较早 Separate 的关键帧（相同空间尺寸），或连接一个普通视频 latent，以在每个新槽位复制最近的帧（例如在时序放大之后）。这些内容仍会被去噪，而不会作为引导固定。除非设置了 `frame_indices`，否则会忽略 keyframes latent 上记录的索引。仅当采样从低于 sigma 1 开始时才会生效。	LATENT	否	N/A
`frame_indices`	可选的像素帧索引。留空时，根据当前画布上的 `interval_frames` 进行放置。设置后，此列表即为放置位置（连接的 keyframes 按顺序匹配）。允许最后一帧；不允许第 0 帧（它已经是独立 token）。（默认：空字符串）	STRING	否	以逗号分隔的整数；1 到最后一个像素帧（不包括第 0 帧）

注意： latent 必须是普通 5D 视频 latent，并在 Concat AV Latent 之前添加生成关键帧。设置 frame_indices 时，列出的每个像素帧必须唯一，且不能已经包含图像关键帧、引导或生成关键帧。如果 frame_indices 为空，则自动跳过已占用的像素；如果不存在空闲的细节槽位，节点会报错。当追加到现有生成关键帧时，latent 仍必须具有相同的每帧 token 数，并且现有块必须结束于最后一个 latent 帧。

输出

输出名称	描述	数据类型
`positive`	附加了生成关键帧注意力的正向条件。	CONDITIONING
`negative`	附加了生成关键帧注意力的负向条件。	CONDITIONING
`latent`	在 T 上追加了生成关键帧的视频 latent。	LATENT

说明

interval_frames 参数设置自动放置关键帧的间距。值越高，关键帧越少且间距越宽；值越低，生成的关键帧越多。
keyframes 输入允许你使用现有 keyframes 或视频 latent 初始化新关键帧。如果提供的是较长的普通视频 latent，则会在每个新槽位复制最近的视频帧。这些关键帧仍会被去噪，不会作为引导固定。
frame_indices 参数允许你指定关键帧应放置的确切像素帧索引。提供后，interval_frames 会被忽略。该列表必须包含有效像素范围内的唯一整数，且不允许第 0 帧。
positive 和 negative 输出包含附加了生成关键帧注意力的条件。
latent 输出包含在 T 上追加了生成关键帧的视频 latent。
需要一个针对生成关键帧训练的 checkpoint（即带有 keyframes_abs_pos_embedding 的 checkpoint）。
使用 LTXV Separate Generated Keyframes 将生成的 keyframes 取出。

本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！在 GitHub 上编辑

Source fingerprint (SHA-256): 43053d15eceb61f37223c46dd46417c71f0503ef3a412ee50a3b2f764f310a64