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

# PixverseV6FusionVideoNode - ComfyUI Built-in Node Documentation

> PixVerse V6 Fusion (Reference to Video) composes a video from reference subjects, backgrounds and videos with PixVerse.

PixVerse V6 Fusion (Reference to Video) composes a video from reference subjects, backgrounds and videos with PixVerse. Place a reference in the scene by naming it in the prompt, for example '@Subject1 walks through @Background1'. Connecting a reference video switches the model to Omni mode, where the output length matches the longest reference video.

## Inputs

### Common Inputs

| Parameter | Description                                                                                                                             | Data Type      | Required | Range         |
| --------- | --------------------------------------------------------------------------------------------------------------------------------------- | -------------- | -------- | ------------- |
| `model`   | Model and generation settings. Selects the model and exposes its generation settings below. The only available option is "PixVerse V6". | DYNAMIC\_COMBO | Yes      | "PixVerse V6" |

### PixVerse V6 Inputs

| Parameter          | Description                                                                                                                                                                           | Data Type | Required | Range                                                     |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- | -------- | --------------------------------------------------------- |
| `prompt`           | Prompt for the video generation. Refer to connected references as @Subject1, @Background1, @Video1. Default: empty.                                                                   | STRING    | Yes      | 1 to 5000 characters                                      |
| `aspect_ratio`     | Output aspect ratio. The "auto" option is only allowed when at least one reference video is connected.                                                                                | COMBO     | Yes      | "auto"<br />plus the predefined PixVerse V6 aspect ratios |
| `quality`          | Output resolution. Sets the long edge: 360p is 640px, 540p 1024px, 720p 1280px, 1080p 1920px. Default: "720p".                                                                        | COMBO     | Yes      | "360p"<br />"540p"<br />"720p"<br />"1080p"               |
| `duration_seconds` | Length of the generated video in seconds. When reference videos are connected, the output length instead follows the longest reference video and this setting is ignored. Default: 5. | INT       | Yes      | 1 to 15                                                   |
| `generate_audio`   | Generate a native audio track together with the video. Default: True.                                                                                                                 | BOOLEAN   | Yes      | True<br />False                                           |
| `seed`             | Seed for video generation. PixVerse records it but does not reproduce a run from it. Default: 42.                                                                                     | INT       | Yes      | 0 to 2147483647                                           |
| `negative_prompt`  | An optional text description of undesired elements in the video. Default: empty.                                                                                                      | STRING    | No       | Up to 2048 characters                                     |
| `style`            | An optional visual style applied to the whole video. Default: "none".                                                                                                                 | COMBO     | No       | "none"<br />plus the predefined PixVerse V6 styles        |

### Reference Inputs

| Parameter     | Description                                                                                                                                                                                                                                                                                                                                 | Data Type | Required | Range                                                        |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- | -------- | ------------------------------------------------------------ |
| `subjects`    | Growable slot: connect reference images of the subjects to place in the scene. Slots are named subject1 to subject8; reference them in the prompt as @Subject1, @Subject2, and so on.                                                                                                                                                       | IMAGE     | No       | 0 to 8 images                                                |
| `backgrounds` | Growable slot: connect reference images of the scene the subjects are placed into. Slots are named background1 to background2; reference them in the prompt as @Background1, @Background2.                                                                                                                                                  | IMAGE     | No       | 0 to 2 images                                                |
| `videos`      | Growable slot: connect reference videos to borrow subjects, motion, framing or style from. Slots are named video1 to video2; reference them in the prompt as @Video1, @Video2. Each video must be at most 15 seconds long, and the total duration must not exceed 15 seconds. Connecting at least one video switches the node to Omni mode. | VIDEO     | No       | 0 to 2 videos<br />15 seconds max each<br />15 seconds total |

Note: Connect at least one subject, background or reference video. Reference tags in the prompt (for example @Subject1, @Background1, @Video1) must match connected slots, otherwise the request is rejected. When at least one reference video is connected (Omni mode), the output length matches the longest reference video, `duration_seconds` is ignored, `aspect_ratio` can be set to "auto", and up to 10 reference images are accepted. Without a reference video, at most 7 reference images (subjects and backgrounds combined) are accepted, and "auto" aspect ratio is not allowed.

## Outputs

| Output Name | Description                                           | Data Type |
| ----------- | ----------------------------------------------------- | --------- |
| `video`     | The generated fusion video, downloaded from PixVerse. | 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/PixverseV6FusionVideoNode/en.md)

***

**Source fingerprint (SHA-256):** `a83ef07f6f1918921e93fa67c2eca351754794f629aa216ccff21ce80901aebd`