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"`
`avatar`	Avatar look to present the video. The available options depend on the selected engine – when engine is `"auto"` a curated list of HeyGen’s public avatars is shown; for specific engines only avatars that support that engine are listed.	COMBO	Yes	Varies based on `engine` selection; see tooltip on the widget.
`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. When `"script"` is chosen, see the sub-parameters below; when `"audio"` is chosen, provide an audio file for lip-sync.	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. If provided, must start with `#`.	STRING	No
`seed`	Not sent to HeyGen; change it to force a re-run (default: `42`).	INT	No	Min: 0 Max: 2147483647

Sub‑parameters when `speech` is `"script"`

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 (includes default voice plus HeyGen’s general voice library).
`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

Sub‑parameters when `speech` is `"audio"`

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

​Sub‑parameters when speech is "script"

​Sub‑parameters when speech is "audio"

​Outputs

Inputs

Sub‑parameters when `speech` is `"script"`

Sub‑parameters when `speech` is `"audio"`

Outputs