The Vidu2 Reference-to-Video Generation node creates a video from a text prompt and multiple reference images. You can define up to seven subjects, each with its own set of reference images, and reference them in the prompt using `@subject{subject_id}`. The node generates a video with configurable duration, aspect ratio, and movement.

## Inputs

| Parameter | Description | Data Type | Required | Range |
| --- | --- | --- | --- | --- |
| `model` | The AI model to use for video generation. | COMBO | Yes | `"viduq2"` |
| `subjects` | For each subject, provide up to 3 reference images (7 images total across all subjects). Reference them in prompts via `@subject{subject_id}`. | AUTOGROW | Yes | N/A |
| `prompt` | The text description used to guide the video generation. When the `audio` parameter is enabled, the video will include generated speech and background music based on this prompt. | STRING | Yes | N/A |
| `audio` | When enabled, the video will contain generated speech and background music based on the prompt (default: `False`). | BOOLEAN | No | N/A |
| `duration` | The length of the generated video in seconds (default: `5`). | INT | No | 1 to 10 |
| `seed` | A number used to control the randomness of the generation for reproducible results (default: `1`). | INT | No | 0 to 2147483647 |
| `aspect_ratio` | The shape of the video frame. | COMBO | No | `"16:9"`<br>`"9:16"`<br>`"4:3"`<br>`"3:4"`<br>`"1:1"` |
| `resolution` | The pixel resolution of the output video (default: `"720p"`). | COMBO | No | `"720p"`<br>`"1080p"` |
| `movement_amplitude` | Controls the movement amplitude of objects in the frame (default: `"auto"`). | COMBO | No | `"auto"`<br>`"small"`<br>`"medium"`<br>`"large"` |

**Constraints:**

* The `prompt` must be between 1 and 2000 characters long.
* You can define multiple subjects, but the total number of reference images across all subjects must not exceed 7.
* Each individual subject can have a maximum of 3 reference images.
* Each reference image must have a width-to-height ratio between 1:4 and 4:1.
* Each reference image must be at least 128 pixels in both width and height.

## Outputs

| Output Name | Description | Data Type |
| --- | --- | --- |
| `output` | The generated video file. | VIDEO |

> This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Vidu2ReferenceVideoNode/en.md)

---
**Source fingerprint (SHA-256):** `73366d1ae9d64428141a7f9de3f9632f12e41918f85771a9a41619564c88ed38`
