---
title: "HeyGen Avatar 6 Turbo"
description: "用一张人像照片和一段语音生成 1080p 对口型视频，可用提示词控制动作与表情。"
seo:
  title: "HeyGen Avatar 6 Turbo API 文档：参数与调用示例"
  description: "HeyGen Avatar 6 Turbo API 文档：模型 ID heygen/heygen-avatar-6-turbo、输入模式、参数取值与默认值，附请求示例。用一张人像照片和一段语音生成 1080p 对口型视频，可用提示词控制动作与表情。"
---

{/* 由 scripts/generate-model-pages.mjs 根据 openapi/model-contracts.json 生成，请勿手改；补充说明写在 docs/zh/models/_notes/heygen/heygen-avatar-6-turbo.mdx */}

| 模型 ID | 别名 | 接口 |
| --- | --- | --- |
| `heygen/heygen-avatar-6-turbo` | `heygen-avatar-6-turbo`、`avatar-6-turbo` | [视频生成](/zh/docs/guides/video-generation) |

## 输入模式

| 模式 | 参考数量 | 参考角色 |
| --- | --- | --- |
| `reference` 参考素材 | 2 | `reference_image`、`reference_audio` |

以下输入模式可在明确支持的渠道省略文字： `reference`

提示词上限：1200 个字符，超出时返回 400。

## 参数

| 参数 | 说明 | 取值 | 默认值 | 必填 |
| --- | --- | --- | --- | --- |
| `resolution` | 分辨率：输出内容的分辨率。 | `1080p` | `1080p` | 否 |
| `aspect_ratio` | 画幅：输出内容的宽高比。 | `auto` | `auto` | 否 |
| `n` | 单次请求输出数量：单次 API 请求（一个 Job）的输出数量，不是应用的批量张数。应用可提交多个独立请求组成一批；n=1 不表示应用只能生成一张。 | `1` | `1` | 否 |

## 示例

`reference` 输入：

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

完整合同以 `GET /v1/models/heygen/heygen-avatar-6-turbo?view=contract` 为准。参数合法不代表每个渠道都能执行，请对完整请求[报价](/zh/docs/concepts/billing#获取报价)。价格与渠道见[模型市场](https://yir.ai/zh/models)。

用 `reference_image` 传一张人像照片，用 `reference_audio` 传一段语音。可用 `input.prompt` 描述动作和表情。fal 路线交付一段 1080p 视频，画幅跟随照片，时长跟随音频。

刊例价为 $0.05／输出秒。通过 Files API 上传音频，再传 `file_id`，即可按实测音频时长获取任务估价并使用 `max_cost`。最终按 fal 的逐任务实扣结算。

Yir 当前提供 1080p 照片加语音。[HeyGen 原厂 API](https://developers.heygen.com/docs/models/avatar-6) 还提供 2K、参考视频及预设数字人。
