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

# WanReferenceVideoApi - ComfyUI Built-in Node Documentation

> Complete documentation for the WanReferenceVideoApi 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/WanReferenceVideoApi/zh.md)

Wan Reference to Video 节点利用一个或多个输入参考视频的视觉外观和语音，结合文本提示词，生成新的视频内容。它在保持与参考素材中角色一致性的同时，根据您的描述创造新的内容。

## 输入参数

| 参数                 | 数据类型     | 必填 | 取值范围                                                                                                                                                                                                                                                                                                                | 描述                                                                                      |
| ------------------ | -------- | -- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
| `model`            | COMBO    | 是  | `"wan2.6-r2v"`                                                                                                                                                                                                                                                                                                      | 用于视频生成的具体 AI 模型。                                                                        |
| `prompt`           | STRING   | 是  | -                                                                                                                                                                                                                                                                                                                   | 对新视频中元素和视觉特征的描述。支持英文和中文。使用如 `character1`、`character2` 等标识符来指代参考视频中的角色。                  |
| `negative_prompt`  | STRING   | 否  | -                                                                                                                                                                                                                                                                                                                   | 描述希望在生成视频中避免出现的元素或特征。                                                                   |
| `reference_videos` | AUTOGROW | 是  | -                                                                                                                                                                                                                                                                                                                   | 用作角色外观和语音参考的视频输入列表。您必须提供至少一个视频。每个视频可以分配一个名称，如 `character1`、`character2` 或 `character3`。 |
| `size`             | COMBO    | 是  | `"720p: 1:1 (960x960)"`<br />`"720p: 16:9 (1280x720)"`<br />`"720p: 9:16 (720x1280)"`<br />`"720p: 4:3 (1088x832)"`<br />`"720p: 3:4 (832x1088)"`<br />`"1080p: 1:1 (1440x1440)"`<br />`"1080p: 16:9 (1920x1080)"`<br />`"1080p: 9:16 (1080x1920)"`<br />`"1080p: 4:3 (1632x1248)"`<br />`"1080p: 3:4 (1248x1632)"` | 输出视频的分辨率和宽高比。                                                                           |
| `duration`         | INT      | 是  | 5 到 10                                                                                                                                                                                                                                                                                                              | 生成视频的长度，单位为秒。该值必须是 5 的倍数（默认值：5）。                                                        |
| `seed`             | INT      | 否  | 0 到 2147483647                                                                                                                                                                                                                                                                                                      | 用于获得可重现结果的随机种子值。值为 0 时将生成一个随机种子。                                                        |
| `shot_type`        | COMBO    | 是  | `"single"`<br />`"multi"`                                                                                                                                                                                                                                                                                           | 指定生成的视频是单个连续镜头，还是包含多个带有剪辑的镜头。                                                           |
| `watermark`        | BOOLEAN  | 否  | -                                                                                                                                                                                                                                                                                                                   | 启用后，会在最终视频上添加一个 AI 生成的水印（默认值：False）。                                                    |

**约束条件：**

* `reference_videos` 中提供的每个视频时长必须在 2 到 30 秒之间。
* `duration` 参数仅限于特定值（5 或 10 秒）。

## 输出参数

| 输出名称     | 数据类型  | 描述        |
| -------- | ----- | --------- |
| `output` | VIDEO | 新生成的视频文件。 |