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

# HeyGen Avatar 6 in ComfyUI: Photo and Identity to Video

> Make a photo, a stylized character, or a HeyGen avatar speak in ComfyUI with Avatar 6: your own audio, a written script, 1080p and 2K output.

**HeyGen Avatar 6** turns a photo, a short character video, or a HeyGen avatar look into a talking clip, lip-synced to speech you supply or write.

In ComfyUI it runs through two partner nodes. **HeyGen Avatar 6 Reference to Video** animates a photo or a stylized character with your own audio track. **HeyGen Avatar 6 Identity to Video** renders a stock or custom avatar from a written script, in a voice you pick. Both are cloud API nodes: they need a Comfy account with credits and download no local model. Rates are on the [partner node pricing page](https://docs.comfy.org/tutorials/partner-nodes/pricing.md).

Every run renders at 1080p or 2K, in 16:9, 9:16, 1:1, 4:5, or 5:4, and the clip length follows the speech. `heygen-avatar-6` is the default engine; `heygen-avatar-6-turbo` is the faster, cheaper option.

> [!TIP]
>
> To use the Partner Nodes, you need to ensure that you are logged in properly and using a permitted network environment. Please refer to the [Partner Nodes Overview](https://docs.comfy.org/tutorials/partner-nodes/overview.md) section of the documentation to understand the specific requirements for using the Partner Nodes.

> [!TIP]
>
> > [tab] Local users
> >
> > Make sure your ComfyUI is updated.
> >
> > * [Download ComfyUI](https://www.comfy.org/download)
> > * [Update Guide](https://docs.comfy.org/installation/update_comfyui.md)
> >
> > Workflows in this guide can be found in the [Workflow Templates](https://docs.comfy.org/interface/features/template.md).
> > If you can't find them in the template, your ComfyUI may be outdated.
> >
> > If nodes are missing when loading a workflow, possible reasons:
> >
> > 1. You are not using the latest ComfyUI version (Nightly version)
> > 2. Some nodes failed to import at startup
>
> > [tab] Cloud users
> >
> > * [Cloud](https://cloud.comfy.org) will update after ComfyUI stable release.
> >
> > So, if you find any core node missing in this document, it might be because the new core nodes have not yet been released in the latest stable version. Please wait for the next stable release.

## Available workflows

### Photo or video to video

Turns one photo, one short video of a stylized character, or both, into a talking clip in your own audio. The audio sets the length of the render.

* The photo sets the identity and the scene. It is not used as the first frame: the model re-stages the pose, so a photo with arms crossed comes back re-posed.
* The reference video shows how the character talks and moves, at least 2 seconds long. Longer clips are trimmed to the first 30 seconds. Videos of realistic people are refused; connect a photo of the person instead.
* Audio runs from 1.5 seconds to 10 minutes.

<video controls src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/api_heygen_avatar_6_i2v.mp4" />

> [card] [Run on Comfy Cloud](https://cloud.comfy.org/?template=api_heygen_avatar_6_i2v\&utm_source=docs\&utm_medium=referral\&utm_campaign=heygen-avatar-6)
>
> Open in Comfy Cloud

> [card] [Download Workflow](https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_heygen_avatar_6_i2v.json)
>
> Download JSON or search "HeyGen Avatar 6: Photo to Video" in Template Library

**Input materials**

> [card] [pink\_hair\_portrait.png](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/pink_hair_portrait.png)
>
> Load into the `image` input

> [card] [avatar6\_narration.mp3](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/avatar6_narration.mp3)
>
> Load into the `audio` input

### Identity to video

Renders a presenter without a shoot: pick a stock look or an avatar you created, write the line, and choose a voice. With `speech` set to `script` the node needs nothing connected; with `audio`, connect a Load Audio node to the `audio` input.

`speech` has two modes. **script** writes the line into `text` (up to 5000 characters) and speaks it in the selected `voice`, with an optional `voice_speed` multiplier. **audio** takes your own clip of 0.5 seconds to 10 minutes, and the clip length becomes the render length.

<video controls src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/api_heygen_avatar_6_id2v.mp4" />

> [card] [Run on Comfy Cloud](https://cloud.comfy.org/?template=api_heygen_avatar_6_id2v\&utm_source=docs\&utm_medium=referral\&utm_campaign=heygen-avatar-6)
>
> Open in Comfy Cloud

> [card] [Download Workflow](https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_heygen_avatar_6_id2v.json)
>
> Download JSON or search "HeyGen Avatar 6: Identity to Video" in Template Library

The template also ships two bypassed groups that create your own avatar and voice. Select a group's nodes, press **Ctrl+B** to clear the bypass, then run the graph with **Run** or **Ctrl+Enter** and reuse the saved ID. Clear the `string_a` prefix in **Concatenate Text** first, or copy the raw ID from the creation node's output, because the saved text is the prefix followed by the ID:

* **Avatar**: `HeyGen Create Avatar` with `source` set to `photo` returns a look ID. Set `avatar` to `custom avatar` on the main node and paste the ID into `custom_avatar_id`. `pink_hair_portrait.png` ships with the template.
* **Voice**: `HeyGen Voice 1.0 Instant Clone` returns a voice ID from at least 10 seconds of clean single-speaker audio. Paste it into `custom_voice_id`; it overrides the `voice` dropdown whenever it is not empty. `avatar6_voice_sample.mp3` ships with the template.

## Node controls

| Control | Values | Applies to | Effect |
| - | - | - | - |
| `model` | `heygen-avatar-6`, `heygen-avatar-6-turbo` | both nodes | Engine. Turbo is cheaper and faster |
| `resolution` | `1080p`, `2k` | both nodes | 16:9 renders 1920x1080 at `1080p` and 2880x1620 at `2k` |
| `aspect_ratio` | `auto`, `16:9`, `9:16`, `1:1`, `4:5`, `5:4` | both nodes | `auto` follows the photo, or the video when no photo is connected, and the avatar's source footage on Identity to Video. Other values re-frame the scene |
| `motion_prompt` | text, up to 1200 characters | both nodes | Gestures, expression, posture, and camera movement |
| `motion_expressiveness` | `less`, `default` | both nodes | `less` damps the gestures. The motion prompt wins where they overlap |
| `seed` | integer | both nodes | Controls whether the node re-runs; results vary between runs anyway |
| `image` | one photo | Reference to Video | Identity and scene for the clip. Not used as the first frame |
| `video` | one clip, 2 to 30 seconds | Reference to Video | How the character talks and moves. Realistic people are refused |
| `audio` | 1.5 seconds to 10 minutes | Reference to Video | The speech to lip-sync, and the length of the clip |
| `avatar` | stock looks, `custom avatar` | Identity to Video | The presenter. `custom avatar` reveals `custom_avatar_id` |
| `speech` | `script`, `audio` | Identity to Video | A written line with a chosen voice, or your own audio clip |

Reference to Video needs an image, a video, or both connected. Identity to Video needs no inputs in `script` mode; `audio` mode needs an audio input.

## Prompting tips

* **Direct the performance in `motion_prompt`**. Say how the avatar speaks and moves: gestures on the key words, relaxed shoulders, a slight head tilt, and a slow push-in on camera. Leave it empty for a neutral delivery.
* **Keep gestures small when the frame is tight**. Set `motion_expressiveness` to `less` for head-and-shoulders crops, where wide gestures leave the frame.
* **Use clean single-speaker audio**. Background music or a second voice in the track shows up in the lip sync. For a voice clone, 10 seconds of continuous speech is enough.
* **Frame the photo before connecting it**. `auto` keeps the photo's shape, so crop to the aspect ratio you want instead of re-framing afterwards.

## Get started

1. Update ComfyUI to the latest version
2. Go to Template Library, search for `HeyGen Avatar 6`


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