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

# LTXVAddGuide - ComfyUI Built-in Node Documentation

> Complete documentation for the LTXVAddGuide node in ComfyUI. Learn its inputs, outputs, parameters and usage.

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

## 概述

LTXVAddGuide 节点通过编码输入图像或视频并将其作为关键帧融入条件数据，为潜在序列添加视频条件引导。该节点通过 VAE 编码器处理输入，并将生成的潜在表示策略性地放置在指定帧位置，同时使用关键帧信息更新正向和负向条件数据。该节点处理帧对齐约束，并允许控制条件影响的强度。

## 输入

| 参数     | 数据类型         | 必填 | 取值范围         | 描述                                                                                                                         |
| ------ | ------------ | -- | ------------ | -------------------------------------------------------------------------------------------------------------------------- |
| `正向`   | CONDITIONING | 是  | -            | 待使用关键帧引导修改的正向条件输入                                                                                                          |
| `负向`   | CONDITIONING | 是  | -            | 待使用关键帧引导修改的负向条件输入                                                                                                          |
| `vae`  | VAE          | 是  | -            | 用于编码输入图像/视频帧的 VAE 模型                                                                                                       |
| `潜在空间` | LATENT       | 是  | -            | 将接收条件帧的输入潜在序列                                                                                                              |
| `图像`   | IMAGE        | 是  | -            | 用于为潜在视频添加条件的图像或视频。必须为 8*n + 1 帧。如果视频不是 8*n + 1 帧，将被裁剪至最接近的 8\*n + 1 帧。                                                     |
| `帧索引`  | INT          | 否  | -9999 到 9999 | 开始添加条件引导的帧索引。对于单帧图像或 1-8 帧的视频，任何 frame\_idx 值均可接受。对于 9+ 帧的视频，frame\_idx 必须能被 8 整除，否则将向下取整至最接近的 8 的倍数。负值表示从视频末尾开始计数。（默认值：0） |
| `强度`   | FLOAT        | 否  | 0.0 到 1.0    | 条件影响的强度，1.0 表示应用完整条件，0.0 表示不应用条件（默认值：1.0）                                                                                  |

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

## 输出

| 输出名称   | 数据类型         | 描述                  |
| ------ | ------------ | ------------------- |
| `负向`   | CONDITIONING | 使用关键帧引导信息更新后的正向条件数据 |
| `潜在空间` | CONDITIONING | 使用关键帧引导信息更新后的负向条件数据 |
| `潜在空间` | LATENT       | 包含条件帧并更新了噪声掩码的潜在序列  |