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

# HeyGenTalkingPhotoNode - ComfyUI Built-in Node Documentation

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

Animate a still image of a person into a lip-synced talking video using HeyGen's Avatar IV technology. You can drive the animation with a text script that HeyGen converts to speech, or provide your own audio for the avatar to lip-sync.

## Inputs

| Parameter         | Description                                                                                                                  | Data Type | Required                      | Range                                                                       |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------------- | --------- | ----------------------------- | --------------------------------------------------------------------------- |
| `image`           | Image of a person to animate. Downscaled automatically if larger than 2K.                                                    | IMAGE     | Yes                           | -                                                                           |
| `speech`          | Drive the avatar with a text script (HeyGen text-to-speech) or your own audio.                                               | COMBO     | Yes                           | `"script"`<br />`"audio"`                                                   |
| `text`            | Text for the avatar to speak (up to 5000 characters). The generated speech must be at least 1 second long.                   | STRING    | Yes (when speech is "script") | -                                                                           |
| `voice`           | Voice for the script (HeyGen's most popular voices).                                                                         | COMBO     | Yes (when speech is "script") | 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                            | 0.5 to 1.5                                                                  |
| `audio`           | Audio for the avatar to lip-sync, up to 10 minutes.                                                                          | AUDIO     | Yes (when speech is "audio")  | -                                                                           |
| `resolution`      | Output video resolution (default: "1080p").                                                                                  | COMBO     | No                            | `"720p"`<br />`"1080p"`                                                     |
| `aspect_ratio`    | Output aspect ratio. 'auto' follows the input image (default: "auto").                                                       | COMBO     | No                            | `"auto"`<br />`"16:9"`<br />`"9:16"`<br />`"1:1"`<br />`"4:5"`<br />`"5:4"` |
| `expressiveness`  | How expressive the animated face and gestures are (default: "low").                                                          | COMBO     | No                            | `"low"`<br />`"medium"`<br />`"high"`                                       |
| `seed`            | Not sent to HeyGen; change it to force a re-run (default: 42).                                                               | INT       | No                            | 0 to 2147483647                                                             |

## Outputs

| Output Name | Description                                                           | Data Type |
| ----------- | --------------------------------------------------------------------- | --------- |
| `video`     | Generated video of the animated talking photo with lip-synced speech. | 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/HeyGenTalkingPhotoNode/en.md)

***

**Source fingerprint (SHA-256):** `2181066a8c6191cfcaa15ece4f89a16c37e76aa22763d6df4007baa20336f05a`