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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.