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

| 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.                                                                   | COMBO     | Yes      | `"auto"`<br />`"avatar_iv"`<br />`"avatar_iii"`<br />`"avatar_v"`           |
| `avatar`           | Avatar look to present the video. With engine `"auto"`, it is curated from HeyGen's public library and the best engine the look supports is chosen automatically. With engine `"avatar_iv"`, `"avatar_iii"`, or `"avatar_v"`, only avatar looks that support that engine are listed. | COMBO     | Yes      | Varies based on the `engine` selection                                      |
| `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.                                                                                                                             | STRING    | No       |                                                                             |
| `speech`           | Drive the avatar with a text script (HeyGen text-to-speech) or your own audio. When `"script"` is chosen, see the sub-parameters below; when `"audio"` is chosen, provide an audio file for lip-sync.                                                                                | 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 `#`.                                                                                                                           | STRING    | No       |                                                                             |
| `seed`             | Not sent to HeyGen; change it to force a re-run (default: `42`).                                                                                                                                                                                                                     | INT       | No       | Min: 0<br />Max: 2147483647                                                 |

### Sub-parameters when `speech` is `"script"`

| 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.                   | STRING    | Yes      |                                                                                |
| `voice`           | Voice for the script. The default option uses the voice HeyGen assigned to the avatar.                                       | COMBO     | Yes      | Multiple options available (default voice plus HeyGen's general voice library) |
| `custom_voice_id` | Optional HeyGen voice ID. When set, overrides the voice selected above. Any voice from HeyGen's library (2000+) can be used. | STRING    | No       |                                                                                |
| `voice_speed`     | Speech speed multiplier (default: `1.0`).                                                                                    | FLOAT     | No       | Min: 0.5<br />Max: 1.5<br />Step: 0.05                                         |

### Sub-parameters when `speech` is `"audio"`

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

## 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):** `009bc72b841ca273af83fe6f80fb24d4b11c2efd96c011795b1ff1cf8e66ee61`