> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# LTXVAddGeneratedKeyframes - ComfyUI Built-in Node Documentation

> LTXV Add Generated Keyframes 节点将细节关键帧追加到视频 latent。

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 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVAddGeneratedKeyframes/zh.md)

***

**Source fingerprint (SHA-256):** `43053d15eceb61f37223c46dd46417c71f0503ef3a412ee50a3b2f764f310a64`