HeyGenCreateAvatarNode - ComfyUI Built-in Node Documentation

Create a reusable HeyGen avatar from a photo of a person or from a text prompt describing a character to generate. The resulting avatar_id can be used with the HeyGen Avatar Video node, and should be saved to reuse the avatar in future workflows.

Inputs

Common 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.	DYNAMIC_COMBO	Yes	`"prompt"` `"photo"`

Prompt Inputs

Available when source is set to "prompt".

Parameter	Description	Data Type	Required	Range
`prompt`	Description of the avatar to generate (up to 1000 characters). Must contain at least 1 non-whitespace character. Default: empty string.	STRING	Yes	1 to 1000 characters

Photo Inputs

Available when source is set to "photo".

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

Reference Inputs

Available when source is set to "prompt".

Parameter	Description	Data Type	Required	Range
`reference_images`	Growable slot: connect up to 3 images (`ref_image_1`…`ref_image_3`) guiding the generated look. Images are downscaled automatically if larger than 2K.	IMAGE	No	0 to 3 images

Note: The source parameter switches between two mutually exclusive modes. In "prompt" mode, prompt is required and up to 3 reference images can optionally be connected. In "photo" mode, identity_photo is required. Photos and reference images are downscaled automatically when larger than 2K; more than 3 reference images are not accepted.

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): 3669686fc6d089909bd5d2d75292ceef05702ed3cc7b14e561bcb444c30a4e63

​Inputs

​Common Inputs

​Prompt Inputs

​Photo Inputs

​Reference Inputs

​Outputs