![]()
PoYo 上的 HeyGen Avatar 6 API 有两个模型 ID:HeyGen 的 Avatar 6 Quality 档位 heygen-avatar-6,以及 heygen-avatar-6-turbo。两者共用一个接口、一种请求格式和全部限制,所以选择哪个只是按请求在成本与质量之间做路由决策,而不是一项接入工程。本文列出哪些相同、哪些不同、我们测到了什么,以及一条选择规则。两个模型都在 HeyGen Avatar 6 模型页上。
HeyGen Avatar 6 API 两个档位的相同之处
PoYo 的 HeyGen Avatar 6 文档把 Turbo 描述为“与 Avatar 6 输入和模式相同的 Turbo 档位”。HeyGen 自己的开发者文档也这样说:两个模型“接受相同的输入”。
| 项目 | heygen-avatar-6 | heygen-avatar-6-turbo |
|---|---|---|
| 接口 | POST /api/generate/submit | 相同 |
照片模式(image_urls + audio_url) | 支持 | 支持 |
参考视频模式(video_url + audio_url) | 支持 | 支持 |
公共数字人模式(avatar + text/voice 或 audio_url) | 支持 | 支持 |
| 数字人与音色 | 1,248 个形象,102 个音色 | 同一列表 |
| 音频 | 2–60 秒,最大 15 MB | 相同 |
| 文本 | 最多 1,000 个字符 | 相同 |
prompt | 最多 1,200 个字符 | 相同 |
resolution | 1080p(默认)、2K | 相同 |
aspect_ratio(公共数字人) | 16:9、9:16、1:1、4:5、5:4 | 相同 |
| 计费规则 | 秒数向上取整;音频在提交时扣费,文本先预留后结算 | 相同 |
由于 input 中没有任何变化,在一个模型上能用的请求体在另一个模型上同样能用。切换的只是 model 字符串。
不同之处:价格
1 积分 = $0.005,按输出秒计费:
| 分辨率 | heygen-avatar-6 | heygen-avatar-6-turbo | Turbo 节省 |
|---|---|---|---|
| 1080p | 20 积分($0.10) | 10 积分($0.05) | 50% |
| 2K | 29 积分($0.145) | 18 积分($0.09) | 38% |
只更改模型 ID 时,同一片段的价格:
| 片段 | heygen-avatar-6 | heygen-avatar-6-turbo |
|---|---|---|
| 10 秒,1080p | 200 积分($1.00) | 100 积分($0.50) |
| 10 秒,2K | 290 积分($1.45) | 180 积分($0.90) |
| 30 秒,1080p | 600 积分($3.00) | 300 积分($1.50) |
| 60 秒,1080p | 1,200 积分($6.00) | 600 积分($3.00) |
| 60 秒,2K | 1,740 积分($8.70) | 1,080 积分($5.40) |
还有一个影响路由的对比:2K 的 Turbo(每秒 18 积分)比 1080p 的 Avatar 6(20)更便宜。如果你更需要像素数而不是 Quality 档位,Turbo 2K 是更便宜的选择。
不同之处:HeyGen 所述的质量与速度
HeyGen 在技术报告中把两个档位称为“Avatar 6 Quality”和“Avatar 6 Turbo”,但没有定义两者的区别,也没有公布 Turbo 的延迟数据。它公布的是每个档位与各自前代的对比:879 票中 69.7% 更喜欢 Avatar 6 Quality 而非 Avatar V,863 票中 64.3% 更喜欢 Avatar 6 Turbo 而非 Avatar V Turbo。HeyGen 没有公布 Quality 与 Turbo 之间的投票,所以使用 Turbo 会损失多少,没有官方数据。
我们在上线当天测到的结果
PoYo 团队于 2026 年 11 月 19 日在生产 API 上对每个模型各运行了一次文本请求。耗时是每隔几秒轮询的客户端看到的从提交到出结果的时间,仅供参考。
heygen-avatar-6-turbo | heygen-avatar-6 | |
|---|---|---|
| 数字人 / 音色 | Abigail Office Front / Jessica Anne Bogart | Bryan Tech Expert / Andrew |
| 脚本 | 27 个单词 | 21 个单词 |
| 设置 | 16:9,1080p | 16:9,1080p |
| 输出时长 | 10.16 秒 | 6.88 秒 |
| 费用(按当前价格) | 110 积分(11 秒 × 10) | 140 积分(7 秒 × 20) |
| 耗时 | 约 2.4 分钟 | 约 2 分钟 |
这是脚本和数字人都不同的两次单独运行,所以并不能说明 Turbo 更快或更慢。但它们确实展示了实际的成本差距:更长的 Turbo 片段仍比更短的 Avatar 6 片段便宜。它们也表明两个档位都需要几分钟,所以都不是在请求上同步等待的 API。无论用哪个,都要规划轮询或 callback_url。
该调用哪个 HeyGen Avatar 6 API 模型 ID
| 场景 | 模型 ID | 原因 |
|---|---|---|
| 草稿、脚本与节奏审阅 | heygen-avatar-6-turbo | 1080p 下半价;字段相同,审批通过的请求体可原样在 Avatar 6 上重跑 |
| 大批量个性化片段 | heygen-avatar-6-turbo | 规模化时每秒成本占主导 |
| 用户在你的应用中预览 | heygen-avatar-6-turbo | 用户尝试不同数字人和脚本时可以低成本迭代 |
| 最终的主持人视频或品牌视频 | heygen-avatar-6 | HeyGen 的 Quality 档位 |
| 预算有限但需要 2K | heygen-avatar-6-turbo + 2K | 每秒 18 积分,低于 1080p 的 Avatar 6 |
| 最终 2K 母版 | heygen-avatar-6 + 2K | 最高档位、最高分辨率 |
最自然的做法是两步流水线:所有草稿都用 Turbo 渲染,保存确切的请求体,再把审批通过的请求体改成 "model": "heygen-avatar-6" 重新提交。下面两个请求除了模型之外完全相同:
{
"model": "heygen-avatar-6-turbo",
"input": {
"avatar": "Abigail Office Front",
"text": "Hello and welcome to this demonstration of HeyGen Avatar 6.",
"voice": "Warm Pro Narrator",
"aspect_ratio": "16:9",
"resolution": "1080p"
}
}
{
"model": "heygen-avatar-6",
"input": {
"avatar": "Abigail Office Front",
"text": "Hello and welcome to this demonstration of HeyGen Avatar 6.",
"voice": "Warm Pro Narrator",
"aspect_ratio": "16:9",
"resolution": "1080p"
}
}
使用文本输入时,最终渲染是一次新的生成,所以时长可能与草稿略有不同。使用音频文件时,两次渲染的时长都等于同一段音频,费用与表格预测完全一致。完整的请求流程见 HeyGen Avatar 6 API 指南。
两个档位的错误与重试相同
在两个 ID 之间路由不会改变错误处理。两者返回相同的响应体 code:输入问题(音频不在 2–60 秒内、数字人名称不存在、混用了两种模式的字段)返回 400,余额不足返回 402 insufficient_credits_error,限流返回 429,临时故障返回 5xx。在 Turbo 上返回 400 的请求在 Avatar 6 上同样是 400,所以千万不要为了修复校验错误而“换个档位重试”,应当修正输入。
预留额度跨两个档位共同计算。任一模型上的文本任务都会从提交起占用积分直到结算,402 信息会把它们合并计算。在上线当天的测试中,提交了一个 Turbo 文本任务和一个 Avatar 6 文本任务之后,第三个文本请求(Turbo,2K)被拒绝,返回 HTTP 200,响应体 code 为 402:"this request needs at least 252 credits, and 344 credits are already reserved by your unfinished HeyGen Avatar 6 text tasks." 不论文本任务跑在哪个模型上,都要按所有进行中的任务预留余额。
路由函数
import math
def pick_model(final: bool) -> str:
"""Route a HeyGen Avatar 6 request. Fields stay identical; only the model changes."""
return "heygen-avatar-6" if final else "heygen-avatar-6-turbo"
PRICE_PER_SECOND = { # credits, 1 credit = $0.005
("heygen-avatar-6-turbo", "1080p"): 10,
("heygen-avatar-6-turbo", "2K"): 18,
("heygen-avatar-6", "1080p"): 20,
("heygen-avatar-6", "2K"): 29,
}
def estimate_credits(model: str, resolution: str, audio_seconds: float) -> float:
return math.ceil(audio_seconds) * PRICE_PER_SECOND[(model, resolution)]
对于按向上取整的音频时长计费的音频请求,estimate_credits 的结果是精确的。对于文本请求,计费时长取决于成片,所以它只是一个估算。
常见问题
HeyGen Avatar 6 API 和 HeyGen Avatar 6 Turbo 有什么区别?
价格和 HeyGen 的档位。字段、模式、限制、数字人和音色都相同。Turbo 在 1080p 下每秒 10 积分($0.05),对比 20($0.10);2K 下 18($0.09),对比 29($0.145)。
HeyGen Avatar 6 Turbo 更快吗?
HeyGen 的技术报告和开发者文档都没有公布任一档位的延迟数据。在我们上线当天的两次运行中,使用不同脚本生成短片段都花了约 2 到 2.4 分钟,所以速度需要在你自己的请求上实测。
能不改请求就从 Turbo 切换到 Avatar 6 吗?
可以。把 model 从 heygen-avatar-6-turbo 改为 heygen-avatar-6;input 中的所有内容依然有效。
HeyGen Avatar 6 Turbo 支持 2K 吗?
支持,使用 "resolution": "2K",每秒 18 积分($0.09)。
应该从哪个 HeyGen Avatar 6 API 档位开始?
在调整脚本、提示词和数字人选择时先用 Turbo,最终渲染再交给 heygen-avatar-6。文本生成数字人教程是一个低成本的起点。