PixverseV6FusionVideoNode - ComfyUI Built-in Node Documentation

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” 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" "540p" "720p" "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 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” 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 15 seconds max each 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

Source fingerprint (SHA-256): a83ef07f6f1918921e93fa67c2eca351754794f629aa216ccff21ce80901aebd

​Inputs

​Common Inputs

​PixVerse V6 Inputs

​Reference Inputs

​Outputs

Inputs

Common Inputs

PixVerse V6 Inputs

Reference Inputs

Outputs