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

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

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"`           |
| `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.                                                                                                                                     | 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.                                                                                                       | STRING    | No       |                                                                             |
| `seed`             | Not sent to HeyGen; change it to force a re-run (default: 42).                                                                                                                                                     | INT       | No       | Min: 0<br />Max: 2147483647                                                 |

When `speech` is set to `"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.                   | STRING    | Yes      |                                        |
| `voice`           | Voice for the script. The default option uses the voice HeyGen assigned to the avatar.                                       | COMBO     | Yes      | Multiple 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. | STRING    | No       |                                        |
| `voice_speed`     | Speech speed multiplier (default: 1.0).                                                                                      | FLOAT     | No       | Min: 0.5<br />Max: 1.5<br />Step: 0.05 |

When `speech` is set to `"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      |       |

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