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

# Wan2ReferenceVideoApi - ComfyUI Built-in Node Documentation

> 此节点根据提供的参考素材生成以人物或物体为主角的视频。

此节点根据提供的参考素材生成以人物或物体为主角的视频。它使用 Wan 2.7 模型根据文本提示词创建视频，支持单角色表演和多角色互动。你必须至少提供一个参考视频或参考图像，生成才能正常工作。

## 输入

### 通用输入

| 参数          | 描述                                    | 数据类型           | 必填 | 范围              |
| ----------- | ------------------------------------- | -------------- | -- | --------------- |
| `model`     | 用于视频生成的特定模型。                          | DYNAMIC\_COMBO | 是  | "wan2.7-r2v"    |
| `seed`      | 用于生成的种子，有助于控制输出的随机性（默认值：0）。           | INT            | 是  | 0 到 2147483647  |
| `watermark` | 是否在结果中添加 AI 生成水印（默认值：False）。这是一个高级设置。 | BOOLEAN        | 是  | True<br />False |

### wan2.7-r2v 输入

| 参数                | 描述                                                              | 数据类型   | 必填 | 范围                                                  |
| ----------------- | --------------------------------------------------------------- | ------ | -- | --------------------------------------------------- |
| `prompt`          | 描述视频的提示词。使用 'character1' 和 'character2' 等标识符来指代参考角色。必须至少包含一个角色。 | STRING | 是  | -                                                   |
| `negative_prompt` | 描述需要避免内容的负面提示词（默认值：空）。                                          | STRING | 否  | -                                                   |
| `resolution`      | 输出视频的分辨率。                                                       | COMBO  | 是  | "720P"<br />"1080P"                                 |
| `ratio`           | 输出视频的宽高比。                                                       | COMBO  | 是  | "16:9"<br />"9:16"<br />"1:1"<br />"4:3"<br />"3:4" |
| `duration`        | 生成视频的时长，单位为秒（默认值：5）。                                            | INT    | 是  | 2 到 10                                              |

### 参考输入

| 参数                 | 描述                                                             | 数据类型  | 必填 | 范围          |
| ------------------ | -------------------------------------------------------------- | ----- | -- | ----------- |
| `reference_videos` | 可扩展槽位：最多连接 3 个参考视频（槽位 `video1` 到 `video3`）。总体上至少需要一个参考视频或参考图像。 | VIDEO | 否  | 0 到 3 items |
| `reference_images` | 可扩展槽位：最多连接 5 个参考图像（槽位 `image1` 到 `image5`）。总体上至少需要一个参考视频或参考图像。 | IMAGE | 否  | 0 到 5 items |

**重要约束：**

* 你必须在 `reference_videos` 或 `reference_images` 输入中至少提供一个参考视频或参考图像。否则此节点会报错。
* 参考视频和参考图像的总数不能超过 5。
* `prompt` 输入必须至少包含一个角色。

## 输出

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

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

***

**Source fingerprint (SHA-256):** `52ac550522bf3fe8f57444ce8586fe83be470b893ff8c01292743553cfbd623d`