HeyGenAvatarVideoNode - ComfyUI Built-in Node Documentation

Generate a talking-presenter video from a HeyGen avatar. This node creates a video of an AI avatar speaking your provided text or lip-syncing to your own audio, using HeyGen’s rendering engines.

Inputs

Parameter	Description	Data Type	Required	Range
`engine`	Rendering engine; each choice lists only the avatars that support it. ‘auto’ offers every avatar and picks its best engine (Avatar IV preferred). Avatar V is highest fidelity, Avatar III is the most affordable.	COMBO	Yes	`"auto"` `"avatar_iv"` `"avatar_iii"` `"avatar_v"`
`custom_avatar_id`	Optional HeyGen avatar look ID. When set, overrides the avatar selected above. Any of HeyGen’s 3000+ public looks (or your private avatars) can be used.	STRING	No
`speech`	Drive the avatar with a text script (HeyGen text-to-speech) or your own audio.	COMBO	Yes	`"script"` `"audio"`
`resolution`	Output video resolution (default: “1080p”).	COMBO	No	`"720p"` `"1080p"`
`aspect_ratio`	Output aspect ratio. ‘auto’ follows the avatar’s source footage (default: “auto”).	COMBO	No	`"auto"` `"16:9"` `"9:16"` `"1:1"` `"4:5"` `"5:4"`
`background_color`	Optional solid background color as a hex code (e.g. ‘#00ff00’). Leave empty for the avatar’s own background.	STRING	No
`seed`	Not sent to HeyGen; change it to force a re-run (default: 42).	INT	No	Min: 0 Max: 2147483647

When speech is set to "script", the following sub-parameters are available:

Parameter	Description	Data Type	Required	Range
`text`	Text for the avatar to speak (up to 5000 characters). The generated speech must be at least 1 second long.	STRING	Yes
`voice`	Voice for the script. The default option uses the voice HeyGen assigned to the avatar.	COMBO	Yes	Multiple options available
`custom_voice_id`	Optional HeyGen voice ID. When set, overrides the voice selected above. Any voice from HeyGen’s library (2000+) can be used.	STRING	No
`voice_speed`	Speech speed multiplier (default: 1.0).	FLOAT	No	Min: 0.5 Max: 1.5 Step: 0.05

When speech is set to "audio", the following sub-parameter is available:

Parameter	Description	Data Type	Required	Range
`audio`	Audio for the avatar to lip-sync, up to 10 minutes.	AUDIO	Yes

Outputs

Output Name	Description	Data Type
`VIDEO`	The generated avatar presenter video.	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): 009bc72b841ca273af83fe6f80fb24d4b11c2efd96c011795b1ff1cf8e66ee61

​Inputs

​Outputs

Inputs

Outputs