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

> Complete documentation for the HeyGenCreateAvatarNode node in ComfyUI. Learn its inputs, outputs, parameters and usage.

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

***

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