> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Wan3ReferenceToVideoApi - ComfyUI Built-in Node Documentation

> This node generates a video from a text prompt and optional reference images, videos, and audio using the Wan 3.0 model.

This node generates a video from a text prompt and optional reference images, videos, and audio using the Wan 3.0 model. Reference media can be combined freely and mentioned in the prompt as @Image1, @Video1, and @Audio1. The node submits the generation request to the Wan API and returns the finished video.

## Inputs

### Common Inputs

| Parameter   | Description                                                             | Data Type      | Required | Range                                    |
| ----------- | ----------------------------------------------------------------------- | -------------- | -------- | ---------------------------------------- |
| `model`     | Selects the Wan 3.0 model variant used for generation.                  | DYNAMIC\_COMBO | Yes      | `wan3.0-video`<br />`wan3.0-video-prime` |
| `seed`      | Seed to use for generation. Default: 42.                                | INT            | Yes      | 0 to 2147483647                          |
| `watermark` | Whether to add an AI-generated watermark to the result. Default: false. | BOOLEAN        | Yes      | true<br />false                          |

### wan3.0-video and wan3.0-video-prime Inputs

Both model options share the same parameter set.

| Parameter       | Description                                                                                                                                                                                          | Data Type | Required | Range                                                               |
| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- | -------- | ------------------------------------------------------------------- |
| `prompt`        | Prompt describing the elements and visual features. Supports English and Chinese. Refer to connected reference media as @Image1, @Video1, @Audio1, numbered per type in input order. Default: empty. | STRING    | Yes      | Up to 20,000 characters                                             |
| `resolution`    | Resolution of the output video.                                                                                                                                                                      | COMBO     | Yes      | "1080P"<br />"720P"<br />"480P"                                     |
| `ratio`         | Aspect ratio of the output video. With "adaptive", the output dimensions are derived from the input media.                                                                                           | COMBO     | Yes      | "adaptive"<br />"16:9"<br />"9:16"<br />"1:1"<br />"4:3"<br />"3:4" |
| `duration`      | Output duration in seconds. With "auto", the model chooses a duration that fits the prompt and reference media. The combined duration of reference videos and output must not exceed 30 seconds.     | COMBO     | Yes      | "auto"<br />"2" through "30" (integer seconds)                      |
| `audio`         | Whether the output video contains an audio track. Default: true.                                                                                                                                     | BOOLEAN   | Yes      | true<br />false                                                     |
| `prompt_extend` | Whether to enhance the prompt with AI assistance. Default: true.                                                                                                                                     | BOOLEAN   | Yes      | true<br />false                                                     |

### Reference Inputs

| Parameter          | Description                                                                                                      | Data Type | Required | Range              |
| ------------------ | ---------------------------------------------------------------------------------------------------------------- | --------- | -------- | ------------------ |
| `reference_images` | Growable slot: connect 1 to 10 reference images. References are numbered as image1 to image10 in input order.    | IMAGE     | No       | 0 to 10 images     |
| `reference_videos` | Growable slot: connect 1 to 5 reference videos. References are numbered as video1 to video5 in input order.      | VIDEO     | No       | 0 to 5 videos      |
| `reference_audios` | Growable slot: connect 1 to 5 reference audio clips. References are numbered as audio1 to audio5 in input order. | AUDIO     | No       | 0 to 5 audio clips |

**Constraints:**

* The prompt must contain at least one non-empty character, or at least one reference image, video, or audio input must be connected.
* Reference tags in the prompt must match connected inputs. For example, @Image1 refers to the first connected reference image, @Video2 to the second connected reference video, and @Audio1 to the first connected reference audio. Tags are numbered separately per type in input order.
* Each connected reference image must contain exactly one image, not a batch.
* Each reference video must be 15 seconds or shorter. The total duration of all reference videos must not exceed 15 seconds.
* Each reference audio must be 15 seconds or shorter. The total duration of all reference audios must not exceed 15 seconds.
* When `duration` is not "auto", the total duration of all reference videos plus the selected output duration must not exceed 30 seconds.

## Outputs

| Output Name | Description                                                                              | Data Type |
| ----------- | ---------------------------------------------------------------------------------------- | --------- |
| `video`     | The generated video file. Includes an audio track when the `audio` parameter is enabled. | 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/Wan3ReferenceToVideoApi/en.md)

***

**Source fingerprint (SHA-256):** `09caa8142d71235417a3dfc5676c5f6accc2af1287fad3b7050844dd9453cc64`