HeyGenImageToVideoNode - ComfyUI Built-in Node Documentation

Animate an image into a video with synchronized dialogue and sound using HeyGen Video 1.0. The connected image is used as the first frame, and the generated video keeps its aspect ratio. Describe what should happen, including any spoken lines, in the prompt. The node uploads the image, creates the video job, waits for it to finish and returns the resulting video.

Inputs

Parameter	Description	Data Type	Required	Range
`model`	Model version used for generation. (default: `"heygen-video-1"`)	DYNAMIC_COMBO	Yes	`"heygen-video-1"`
`image`	First frame of the video. Exactly one image is required; a batch is rejected. Crop the image to change the shape of the video, because the output keeps this image’s aspect ratio.	IMAGE	Yes	1 image, aspect ratio 1:4 to 4:1
`prompt`	Description of what happens in the video, including any dialogue. (default: empty string)	STRING	Yes	1 to 32000 characters
`duration`	Duration of the output video in seconds. (default: 5)	INT	Yes	5 to 15
`resolution`	Output resolution. (default: `"768p"`)	COMBO	Yes	`"768p"` `"480p"` `"2k"`
`seed`	Seed for the generation. Results can still vary between runs with the same seed. (default: 42)	INT	Yes	0 to 4294967295

Parameter Constraints

Single image: image must contain exactly one image. Connecting a batch raises an error.
Image aspect ratio: the image must be no wider than 4x its height and no taller than 4x its width (between 1:4 and 4:1); otherwise the run fails.
Prompt required: the prompt must contain at least one non-whitespace character and at most 32000 characters.
Seed: the seed only decides whether the node re-runs; results are not reproducible with the same seed.

Outputs

Output Name	Description	Data Type
`VIDEO`	The generated video with synchronized dialogue and sound, at the aspect ratio of the input image.	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): e15def8ce378572247be7dd197ac469fb655bcecf76521c8e9495bbad34e0284

​Inputs

​Parameter Constraints

​Outputs

Inputs

Parameter Constraints

Outputs