HeyGenTalkingPhotoNode - ComfyUI Built-in Node Documentation - ComfyUI

Animate a still image of a person into a lip-synced talking video using HeyGen’s Avatar IV technology. You can drive the animation with a text script that HeyGen converts to speech, or provide your own audio for the avatar to lip-sync.

Inputs

Common Inputs

Parameter	Description	Data Type	Required	Range
`image`	Image of a person to animate. Downscaled automatically if larger than 2K.	IMAGE	Yes	-
`speech`	Drive the avatar with a text script (HeyGen text-to-speech) or your own audio.	DYNAMIC_COMBO	Yes	`"script"` `"audio"`
`resolution`	Output video resolution (default: `"1080p"`).	COMBO	No	`"720p"` `"1080p"`
`aspect_ratio`	Output aspect ratio. `"auto"` follows the input image (default: `"auto"`).	COMBO	No	`"auto"` `"16:9"` `"9:16"` `"1:1"` `"4:5"` `"5:4"`
`expressiveness`	How expressive the animated face and gestures are (default: `"low"`).	COMBO	No	`"low"` `"medium"` `"high"`
`seed`	Not sent to HeyGen; change it to force a re-run (default: 42).	INT	No	0 to 2147483647

Script Inputs

Shown 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. (default: empty)	STRING	Yes	1 to 5000 characters
`voice`	Voice for the script (HeyGen’s most popular voices).	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. (default: empty)	STRING	No	-
`voice_speed`	Speech speed multiplier (default: 1.0).	FLOAT	No	0.5 to 1.5 (step 0.05)

Audio Inputs

Shown when speech is "audio".

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

Note: When speech is "script", text must be specified, and a voice is required via the voice selector (choosing anything other than the avatar’s default voice) or a custom_voice_id. When speech is "audio", audio is required instead.

Outputs

Output Name	Description	Data Type
`video`	Generated video of the animated talking photo with lip-synced speech.	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): 2181066a8c6191cfcaa15ece4f89a16c37e76aa22763d6df4007baa20336f05a