> ## 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.

# WanVaceToVideo - ComfyUI Built-in Node Documentation

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

WanVaceToVideo 节点为 VACE 控制的视频生成模型准备视频条件数据。它将正向和负向条件与可选的控制视频、控制蒙版和参考图像结合，通过 VAE 进行编码，并输出更新后的条件、空 latent 张量和 trim 值。

## 输入

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

**注意：** 当提供 `control_video` 时，它会被截断为 `length` 帧，并上采样到指定的 `width` 和 `height`；如果它的帧数少于 `length`，则缺失的帧会用中性灰色（值 0.5）填充。当未提供时，会自动创建一个包含 `length` 帧的中性灰色视频。`control_masks` 会被上采样到指定的 `width` 和 `height`，截断为 `length` 帧，如果较短则用值 1.0 填充。蒙版将控制视频分为非活动部分和响应部分，各部分分别进行 VAE 编码，并沿通道维度拼接；蒙版还会下采样到 latent 分辨率。当提供 `reference_image` 时，其第一张图像会被 VAE 编码并前置到 latent 序列中，`trim_latent` 会报告添加的 latent 帧数。latent 帧数计算为 `((length - 1) // 4) + 1`，latent 空间维度为 `height / 8` 和 `width / 8`。

## 输出

| 输出名称          | 描述                                                                            | 数据类型         |
| ------------- | ----------------------------------------------------------------------------- | ------------ |
| `positive`    | 已应用视频控制数据（vace\_frames、vace\_mask、vace\_strength）的正向条件                        | CONDITIONING |
| `negative`    | 已应用视频控制数据（vace\_frames、vace\_mask、vace\_strength）的负向条件                        | CONDITIONING |
| `latent`      | 可用于视频生成的空 latent 张量，形状为 \[batch\_size, 16, latent\_length, height/8, width/8] | LATENT       |
| `trim_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`