# HeyGen Talking Photo

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

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

### Script Inputs

Shown 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. (default: empty) | STRING | Yes | 1 to 5000 characters |
| `voice` | Voice for the script (HeyGen's most popular voices). | 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. (default: empty) | STRING | No | - |
| `voice_speed` | Speech speed multiplier (default: 1.0). | FLOAT | No | 0.5 to 1.5 (step 0.05) |

### Audio Inputs

Shown when `speech` is `"audio"`.

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

Note: When `speech` is `"script"`, `text` must be specified, and a voice is required via the `voice` selector (choosing anything other than the avatar's default voice) or a `custom_voice_id`. When `speech` is `"audio"`, `audio` is required instead.

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