Skip to main content
The WanSoundImageToVideo node generates video content from images with optional audio conditioning. It takes positive and negative conditioning prompts along with a VAE model to create video latents, and can incorporate reference images, audio encoding, control videos, and motion references to guide the video generation process.

Inputs

ParameterDescriptionData TypeRequiredRange
positivePositive conditioning prompts that guide what content should appear in the generated videoCONDITIONINGYes-
negativeNegative conditioning prompts that specify what content should be avoided in the generated videoCONDITIONINGYes-
vaeVAE model used for encoding and decoding the video latent representationsVAEYes-
widthWidth of the output video in pixels (default: 832, must be divisible by 16)INTYes16 to MAX_RESOLUTION
heightHeight of the output video in pixels (default: 480, must be divisible by 16)INTYes16 to MAX_RESOLUTION
lengthNumber of frames in the generated video (default: 77, must be divisible by 4)INTYes1 to MAX_RESOLUTION
batch_sizeNumber of videos to generate simultaneously (default: 1)INTYes1 to 4096
audio_encoder_outputOptional audio encoding that can influence the video generation based on sound characteristics. When provided, the audio features are interpolated and used to condition the video generation.AUDIOENCODEROUTPUTNo-
ref_imageOptional reference image that provides visual guidance for the video content. The image is upscaled to match the specified width and height, then encoded into a latent representation.IMAGENo-
control_videoOptional control video that guides the motion and structure of the generated video. The video is upscaled and encoded, then used to condition the output. Only the first length frames are used.IMAGENo-
ref_motionOptional motion reference that provides guidance for movement patterns in the video. If the input has more than 73 frames, only the last 73 are used. If fewer than 73 frames are provided, the sequence is padded with neutral frames.IMAGENo-

Outputs

Output NameDescriptionData Type
positiveProcessed positive conditioning that has been modified for video generation, including audio embeddings, reference latents, motion references, and control video conditioningCONDITIONING
negativeProcessed negative conditioning that has been modified for video generation, including audio embeddings (set to zero), reference latents, motion references, and control video conditioningCONDITIONING
latentGenerated video representation in latent space that can be decoded into final video frames. The latent tensor has shape [batch_size, 16, latent_t, height/8, width/8] where latent_t is derived from the length parameterLATENT
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): 08aa558c23990f7efae9adede91715bf40afca4b50e416a6cadfd18c3d607b75