HeyGenCreateAvatarNode - ComfyUI Built-in Node Documentation

Create a reusable HeyGen avatar from a photo of a person or from a text prompt that describes a character to generate. The resulting avatar ID can be used with the HeyGen Avatar Video node to create videos featuring this avatar.

Inputs

Parameter	Description	Data Type	Required	Range
`source`	Generate a new character from a text prompt, or create the avatar from a connected photo of a person.	COMBO	Yes	`"prompt"` `"photo"`

When source is set to "prompt", the following additional parameters become available:

Parameter	Description	Data Type	Required	Range
`prompt`	Description of the avatar to generate (up to 1000 characters).	STRING	Yes	1 to 1000 characters
`reference_images`	Up to 3 reference images guiding the generated look.	IMAGE	No	0 to 3 images

When source is set to "photo", the following additional parameter becomes available:

Parameter	Description	Data Type	Required	Range
`identity_photo`	Photo of the person to turn into an avatar. Downscaled automatically if larger than 2K.	IMAGE	Yes	Single image

Note: The source parameter switches between two modes. In "prompt" mode, you provide a text description and optionally up to 3 reference images. In "photo" mode, you provide a single photo of a person. These modes are mutually exclusive.

Outputs

Output Name	Description	Data Type
`avatar_id`	Avatar look ID. Pass it to HeyGen Avatar Video’s `custom_avatar_id`; save it to reuse the avatar later.	STRING
`preview`	Preview image of the generated avatar.	IMAGE

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): c60e9cdb0d91fb5ec6ea83b503b9aa10c978ce065a16c751a52e90c12e70a5e2

​Inputs

​Outputs

Inputs

Outputs