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

# Vidu2ReferenceVideoNode - ComfyUI Built-in Node Documentation

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

Vidu2 参考视频生成节点可根据文本提示词和多张参考图像创建视频。您可以定义最多七个主体，每个主体可提供一组参考图像，并在提示词中使用 `@subject{subject_id}` 来引用它们。该节点可生成时长、宽高比和运动幅度均可配置的视频。

## 输入参数

| 参数名                  | 数据类型     | 必填 | 取值范围                                                          | 描述                                                                       |
| -------------------- | -------- | -- | ------------------------------------------------------------- | ------------------------------------------------------------------------ |
| `model`              | COMBO    | 是  | `"viduq2"`                                                    | 用于视频生成的 AI 模型。                                                           |
| `subjects`           | AUTOGROW | 是  | N/A                                                           | 为每个主体提供最多 3 张参考图像（所有主体的图像总数不超过 7 张）。在提示词中通过 `@subject{subject_id}` 引用它们。 |
| `prompt`             | STRING   | 是  | N/A                                                           | 用于指导视频生成的文本描述。当启用 `audio` 参数时，视频将包含基于此提示词生成的语音和背景音乐。                     |
| `audio`              | BOOLEAN  | 否  | N/A                                                           | 启用后，视频将包含基于提示词生成的语音和背景音乐（默认值：`False`）。                                   |
| `duration`           | INT      | 否  | 1 到 10                                                        | 生成视频的时长，单位为秒（默认值：`5`）。                                                   |
| `seed`               | INT      | 否  | 0 到 2147483647                                                | 用于控制生成随机性的数字，以获得可重现的结果（默认值：`1`）。                                         |
| `aspect_ratio`       | COMBO    | 否  | `"16:9"`<br />`"9:16"`<br />`"4:3"`<br />`"3:4"`<br />`"1:1"` | 视频画面的宽高比。                                                                |
| `resolution`         | COMBO    | 否  | `"720p"`<br />`"1080p"`                                       | 输出视频的像素分辨率。                                                              |
| `movement_amplitude` | COMBO    | 否  | `"auto"`<br />`"small"`<br />`"medium"`<br />`"large"`        | 控制画面中物体的运动幅度。                                                            |

**约束条件：**

* `prompt` 的长度必须在 1 到 2000 个字符之间。
* 可以定义多个主体，但所有主体的参考图像总数不得超过 7 张。
* 每个主体最多只能有 3 张参考图像。
* 每张参考图像的宽高比必须在 1:4 到 4:1 之间。
* 每张参考图像的宽度和高度都必须至少为 128 像素。

## 输出

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