> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-chore-sync-comfy-api-v2-spec.mintlify.site/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 describing a character to generate.

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"`<br />`"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](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/HeyGenCreateAvatarNode/en.md)

***

**Source fingerprint (SHA-256):** `3669686fc6d089909bd5d2d75292ceef05702ed3cc7b14e561bcb444c30a4e63`