---
title: "HeyGen Avatar 6 Turbo"
description: "Turn one portrait and a speech recording into a lip-synced 1080p video. An optional prompt directs the motion and expression."
seo:
  title: "HeyGen Avatar 6 Turbo API Documentation: Parameters & Examples"
  description: "HeyGen Avatar 6 Turbo API documentation: model ID heygen/heygen-avatar-6-turbo, input modes, parameters, defaults and request examples. Turn one portrait and a speech recording into a lip-synced 1080p video. An optional prompt directs the motion and expression."
---

{/* Generated by scripts/generate-model-pages.mjs from openapi/model-contracts.json. Do not edit; write notes in docs/models/_notes/heygen/heygen-avatar-6-turbo.mdx */}

| Model ID | Aliases | Endpoint |
| --- | --- | --- |
| `heygen/heygen-avatar-6-turbo` | `heygen-avatar-6-turbo`, `avatar-6-turbo` | [Video generation](/docs/guides/video-generation) |

## Input modes

| Mode | References | Reference roles |
| --- | --- | --- |
| `reference` Reference media | 2 | `reference_image`, `reference_audio` |

Text is optional in these input modes on explicitly supported channels: `reference`

Prompt limit: 1,200 characters; longer prompts are rejected with 400.

## Parameters

| Parameter | Description | Values | Default | Required |
| --- | --- | --- | --- | --- |
| `resolution` | Resolution: Output resolution. | `1080p` | `1080p` | No |
| `aspect_ratio` | Aspect ratio: Output aspect ratio. | `auto` | `auto` | No |
| `n` | Outputs per request: Number of outputs from one API request (one Job), not the application batch size. For multiple Jobs, submit separate requests; n=1 does not prevent application-managed batching. | `1` | `1` | No |

## Examples

`reference` input:

```json
{
  "model": "heygen/heygen-avatar-6-turbo",
  "input": {
    "type": "reference",
    "prompt": "Face the camera and use small, natural hand gestures while speaking.",
    "references": [
      {
        "role": "reference_image",
        "file_id": "file_..."
      },
      {
        "role": "reference_audio",
        "file_id": "file_..."
      }
    ]
  },
  "parameters": {
    "resolution": "1080p",
    "aspect_ratio": "auto",
    "n": 1
  }
}
```

The authoritative contract is `GET /v1/models/heygen/heygen-avatar-6-turbo?view=contract`. A valid parameter does not mean every channel can run it, so [quote](/docs/concepts/billing#get-a-quote) the complete request. Prices and channels are listed in [Model Market](https://yir.ai/models).

Send one portrait as `reference_image` and one speech recording as `reference_audio`. Use `input.prompt` for optional motion and expression directions. The fal route produces one 1080p video and follows the portrait's aspect ratio and the recording's duration.

The listed rate is $0.05 per output second. Upload the audio through the Files API and pass its `file_id` to get a task estimate and use `max_cost`. The estimate uses the measured recording length. Final settlement uses fal's charge for the task.

Yir currently offers the photo-and-audio mode at 1080p. The [HeyGen API](https://developers.heygen.com/docs/models/avatar-6) also offers 2K, video references and preset avatars.
