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

# WanVaceToVideo - ComfyUI Built-in Node Documentation

> WanVaceToVideo 节点为视频生成模型准备视频条件数据。

WanVaceToVideo 节点为视频生成模型准备视频条件数据。它接收正向和负向条件输入，以及可选的控制视频、遮罩和参考图像，并将它们编码为用于引导视频生成的潜在表示。该节点处理缩放、填充、遮罩和 VAE 编码，以构建适合视频模型的条件结构。

## 输入

| 参数     | 描述                                                                 | 数据类型         | 必填 | 范围                    |
| ------ | ------------------------------------------------------------------ | ------------ | -- | --------------------- |
| `正面条件` | 用于引导生成的正向条件输入                                                      | CONDITIONING | 是  | -                     |
| `负面条件` | 用于引导生成的负向条件输入                                                      | CONDITIONING | 是  | -                     |
| `vae`  | 用于编码图像和视频帧的 VAE 模型                                                 | VAE          | 是  | -                     |
| `宽度`   | 输出视频宽度（像素）（默认值：832，步长：16）                                          | INT          | 是  | 16 to MAX\_RESOLUTION |
| `高度`   | 输出视频高度（像素）（默认值：480，步长：16）                                          | INT          | 是  | 16 to MAX\_RESOLUTION |
| `长度`   | 视频帧数（默认值：81，步长：4）                                                  | INT          | 是  | 1 to MAX\_RESOLUTION  |
| `批量大小` | 同时生成的视频数量（默认值：1）                                                   | INT          | 是  | 1 到 4096              |
| `强度`   | VACE 控制的条件强度（默认值：1.0，步长：0.01）。此值不是 LoRA 强度。LoRA 权重通过单独的 LoRA 节点应用。 | FLOAT        | 是  | 0.0 到 1000.0          |
| `控制视频` | 用于控制条件的可选输入视频。如果未提供，会自动创建中性灰色视频。                                   | IMAGE        | 否  | -                     |
| `控制遮罩` | 用于确定控制视频中哪些部分处于活动状态的可选遮罩。如果未提供，则使用全白遮罩。                            | MASK         | 否  | -                     |
| `参考图像` | 用于附加条件的可选参考图像。提供时，它会被编码并前置到潜在序列中。                                  | IMAGE        | 否  | -                     |

**注意：** 提供 `control_video` 时，它会被截断为 `length` 帧，并缩放到指定的 `width` 和 `height`；如果其帧数少于 `length`，缺失帧将用中性灰色（值 0.5）填充。未提供时，会自动创建长度为 `length` 帧的中性灰色视频。`control_masks` 会缩放到指定的 `width` 和 `height`，截断为 `length` 帧，如果不足则用值 1.0 填充。该遮罩将控制视频分为非活动部分和响应部分，各部分分别经 VAE 编码后在通道维度上拼接；遮罩也会被降采样到潜在分辨率。提供 `reference_image` 时，它会经 VAE 编码并前置到潜在序列中。潜在帧数按 `((length - 1) // 4) + 1` 计算，潜在空间维度为 `height / 8` 和 `width / 8`。

## 输出

| 输出名称       | 描述                                                                       | 数据类型         |
| ---------- | ------------------------------------------------------------------------ | ------------ |
| `正向`       | 已应用视频控制数据（`vace_frames`、`vace_mask`、`vace_strength`）的正向条件                | CONDITIONING |
| `负向`       | 已应用视频控制数据（`vace_frames`、`vace_mask`、`vace_strength`）的负向条件                | CONDITIONING |
| `latent`   | 准备用于视频生成的空潜在张量，形状为 \[batch\_size, 16, latent\_length, height/8, width/8] | LATENT       |
| `裁剪latent` | 使用参考图像时需要修剪的潜在帧数；如果未提供参考图像则为 0                                           | INT          |

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

***

**Source fingerprint (SHA-256):** `2039b7509ce5b731e9e41d9cd2dad022d4c5004751f571a4cf88c1ba0cae405b`