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

# HeyGenAvatarVideoNode - ComfyUI Built-in Node Documentation

> Generate a talking-presenter video from a HeyGen avatar.

Generate a talking-presenter video from a HeyGen avatar. This node creates a video of an AI avatar speaking your provided text or lip-syncing to your own audio, using HeyGen's rendering engines.

## Inputs

### Common Inputs

| Parameter | Description | Data Type | Required | Range |
| - | - | - | - | - |
| `engine` | Rendering engine; each choice lists only the avatars that support it. "auto" offers every avatar and picks its best engine (Avatar IV preferred). Avatar V is highest fidelity, Avatar III is the most affordable. | DYNAMIC\_COMBO | Yes | `"auto"`<br />`"avatar_iv"`<br />`"avatar_iii"`<br />`"avatar_v"` |
| `custom_avatar_id` | Optional HeyGen avatar look ID. When set, overrides the avatar selected above. Any of HeyGen's 3000+ public looks (or your private avatars) can be used. Default: `""`. | STRING | No | |
| `speech` | Drive the avatar with a text script (HeyGen text-to-speech) or your own audio. Display name: "speech source". | DYNAMIC\_COMBO | Yes | `"script"`<br />`"audio"` |
| `resolution` | Output video resolution. Default: `"1080p"`. | COMBO | No | `"720p"`<br />`"1080p"` |
| `aspect_ratio` | Output aspect ratio. "auto" follows the avatar's source footage. Default: `"auto"`. | COMBO | No | `"auto"`<br />`"16:9"`<br />`"9:16"`<br />`"1:1"`<br />`"4:5"`<br />`"5:4"` |
| `background_color` | Optional solid background color as a hex code (e.g. `"#00ff00"`). Leave empty for the avatar's own background. If provided, the value must start with `#`. Default: `""`. | STRING | No | |
| `seed` | Not sent to HeyGen; change it to force a re-run. Default: `42`. | INT | No | Min: 0<br />Max: 2147483647 |

### `auto` Inputs

When `engine` is `"auto"`, the following sub-parameter is available:

| Parameter | Description | Data Type | Required | Range |
| - | - | - | - | - |
| `avatar` | Avatar look to present the video (curated from HeyGen's public library). The best engine the look supports is chosen automatically. | COMBO | Yes | Multiple options available |

### `avatar_iv` Inputs

When `engine` is `"avatar_iv"`, the following sub-parameter is available:

| Parameter | Description | Data Type | Required | Range |
| - | - | - | - | - |
| `avatar` | Avatar looks that support the Avatar IV engine. | COMBO | Yes | Multiple options available |

### `avatar_iii` Inputs

When `engine` is `"avatar_iii"`, the following sub-parameter is available:

| Parameter | Description | Data Type | Required | Range |
| - | - | - | - | - |
| `avatar` | Avatar looks that support the Avatar III engine. | COMBO | Yes | Multiple options available |

### `avatar_v` Inputs

When `engine` is `"avatar_v"`, the following sub-parameter is available:

| Parameter | Description | Data Type | Required | Range |
| - | - | - | - | - |
| `avatar` | Avatar looks that support the Avatar V engine. | COMBO | Yes | Multiple options available |

### `script` Inputs

When `speech` is `"script"`, the following sub-parameters are available:

| Parameter | Description | Data Type | Required | Range |
| - | - | - | - | - |
| `text` | Text for the avatar to speak (up to 5000 characters). The generated speech must be at least 1 second long. Default: `""`. | STRING | Yes | Min: 1 character<br />Max: 5000 characters |
| `voice` | Voice for the script. The default option uses the voice HeyGen assigned to the avatar. Ignored if `custom_voice_id` is set. | COMBO | Yes | `"(avatar's default voice)"`<br />Multiple general voice options available |
| `custom_voice_id` | Optional HeyGen voice ID. When set, overrides the voice selected above. Any voice from HeyGen's library (2000+) can be used. Default: `""`. | STRING | No | |
| `voice_speed` | Speech speed multiplier. Default: `1.0`. | FLOAT | No | Min: 0.5<br />Max: 1.5<br />Step: 0.05 |

### `audio` Inputs

When `speech` is `"audio"`, the following sub-parameter is available:

| Parameter | Description | Data Type | Required | Range |
| - | - | - | - | - |
| `audio` | Audio for the avatar to lip-sync, up to 10 minutes. | AUDIO | Yes | |

Note: `engine` and `speech` are selectors that reveal different sub-parameters depending on the chosen value. The `speech` selector has two mutually exclusive modes: in `"script"` mode, `text` is required; if `custom_voice_id` is provided, it overrides `voice`. In `"audio"` mode, the avatar lip-syncs to the provided audio clip. `background_color` must be a hex color code starting with `#` when provided. When `custom_avatar_id` is set, it overrides the `avatar` selection, and the selected `engine` must be supported by that avatar look; otherwise an error is raised unless `engine` is `"auto"`.

## Outputs

| Output Name | Description | Data Type |
| - | - | - |
| `VIDEO` | The generated avatar presenter video. | VIDEO |

> 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/HeyGenAvatarVideoNode/en.md)

***

**Source fingerprint (SHA-256):** `86dc799d3a8cf2666449b0d422853b12feffb81ce002f84594f9b925d58b522a`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.