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

# LTXVAddGuide - ComfyUI Built-in Node Documentation

> The LTXVAddGuide 节点通过 VAE 编码器对输入图像或视频进行编码，并将它们作为引导关键帧添加到潜空间视频序列中。

The LTXVAddGuide 节点通过 VAE 编码器对输入图像或视频进行编码，并将它们作为引导关键帧添加到潜空间视频序列中。它更新正向和负向条件，并返回修改后的潜空间，提供设置起始帧、条件强度、可选注意力掩码和可选 IC-LoRA 参数的选项。

## 输入

| 参数                  | 描述                                                                                                                                                    | 数据类型                 | 必需 | 范围           |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- | -- | ------------ |
| `正向`                | 用于通过关键帧引导进行修改的正向条件输入。                                                                                                                                 | CONDITIONING         | 是  | -            |
| `负向`                | 用于通过关键帧引导进行修改的负向条件输入。                                                                                                                                 | CONDITIONING         | 是  | -            |
| `vae`               | 用于编码输入图像/视频帧的 VAE 模型。                                                                                                                                 | VAE                  | 是  | -            |
| `潜在空间`              | 将接收条件帧的输入潜空间序列。                                                                                                                                       | LATENT               | 是  | -            |
| `图像`                | 用于对潜空间视频进行条件化的图像或视频。必须为 8*n + 1 帧。如果视频不是 8*n + 1 帧，将裁剪到最接近的 8\*n + 1 帧。                                                                               | IMAGE                | 是  | -            |
| `帧索引`               | 开始条件化的帧索引。对于单帧图像或具有 1-8 帧的视频，任何 `frame_idx` 值均可接受。对于具有 9+ 帧的视频，`frame_idx` 必须能被 8 整除，否则将向下舍入到最接近的 8 的倍数。负值从视频末尾开始计数。默认值：0。                            | INT                  | 是  | -9999 到 9999 |
| `强度`                | 条件影响的强度，其中 1.0 应用完整条件化，0.0 不应用条件化。默认值：1.0。                                                                                                            | FLOAT                | 是  | 0.0 到 10.0   |
| `attention_mask`    | 可选的像素空间空间掩码。通过自注意力控制逐区域的条件影响，并乘以 `strength`。                                                                                                          | MASK                 | 否  | -            |
| `iclora_parameters` | 可选的 IC-LoRA 参数，来自 Get IC-LoRA Parameters 节点。用于根据某些 IC-LoRA（例如 `reference_downscale_factor` > 1 的 IC-LoRA）的要求调整引导处理。当链式连接时，每个 LTXVAddGuide 仅使用连接到它的参数。 | IC\_LORA\_PARAMETERS | 否  | -            |

**注意：** 输入图像/视频的帧数必须遵循 8\*n + 1 模式（例如 1、9、17、25 帧）。如果输入超过此模式，将自动裁剪到最接近的有效帧数。

**关于 `iclora_parameters` 的注意：** 当使用 `reference_downscale_factor` 大于 1 的 IC-LoRA 参数时，潜空间维度（宽度和高度）必须能被该因子整除。如果不满足此条件，节点将引发错误。

**注意：** 编码后的引导帧必须在选定帧位置处适配于潜空间序列内。如果条件化帧超出潜空间序列的长度，节点将引发错误。

**注意：** 不支持向组合音频和视频通道的潜空间添加引导，否则将引发错误。

## 输出

| 输出名称       | 描述                    | 数据类型         |
| ---------- | --------------------- | ------------ |
| `positive` | 已更新关键帧引导信息的正向条件。      | CONDITIONING |
| `negative` | 已更新关键帧引导信息的负向条件。      | CONDITIONING |
| `latent`   | 已纳入条件化帧并更新噪声掩码的潜空间序列。 | LATENT       |

> 本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LTXVAddGuide/zh.md)

***

**Source fingerprint (SHA-256):** `031bc9030dafed85b5ff1cbceae36234e9d5f77f7f4b040267067ecd16a27929`