> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

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. Save the ID to reuse the avatar in future workflows.

## 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"`<br />`"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). Must contain at least 1 non-whitespace character. Default: empty string. | STRING    | Yes      | 1 to 1000 characters |
| `reference_images` | Up to 3 reference images guiding the generated look. Downscaled automatically if larger than 2K.                                        | 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](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/HeyGenCreateAvatarNode/en.md)

***

**Source fingerprint (SHA-256):** `c60e9cdb0d91fb5ec6ea83b503b9aa10c978ce065a16c751a52e90c12e70a5e2`