![]()
У HeyGen Avatar 6 API в PoYo два ID моделей: heygen-avatar-6, уровень Avatar 6 Quality от HeyGen, и heygen-avatar-6-turbo. У них один эндпоинт, один формат запроса и все лимиты общие, поэтому выбор — это решение о маршрутизации каждого запроса с учётом стоимости и качества, а не интеграционный проект. На этой странице: что одинаково, что различается, что мы измерили, и правило выбора. Обе модели есть на странице модели HeyGen Avatar 6.
Что одинаково в двух уровнях HeyGen Avatar 6 API
Документация PoYo по HeyGen Avatar 6 описывает Turbo как «уровень Turbo модели Avatar 6 с теми же входными данными и режимами». Собственная документация 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 s, до 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 s, 1080p | 200 кредитов ($1.00) | 100 кредитов ($0.50) |
| 10 s, 2K | 290 кредитов ($1.45) | 180 кредитов ($0.90) |
| 30 s, 1080p | 600 кредитов ($3.00) | 300 кредитов ($1.50) |
| 60 s, 1080p | 1,200 кредитов ($6.00) | 600 кредитов ($3.00) |
| 60 s, 2K | 1,740 кредитов ($8.70) | 1,080 кредитов ($5.40) |
Ещё одно сравнение, влияющее на маршрутизацию: Turbo в 2K (18 кредитов за секунду) дешевле, чем Avatar 6 в 1080p (20). Если вам важнее количество пикселей, чем уровень Quality, Turbo 2K — более дешёвый способ его получить.
Подробности — в статье Цены HeyGen Avatar 6 API.
Что различается: качество и скорость по данным HeyGen
HeyGen называет уровни «Avatar 6 Quality» и «Avatar 6 Turbo» в своём техническом отчёте, но не определяет разницу между ними и не публикует данные о задержке для Turbo. Публикуется лишь сравнение каждого уровня с его предшественником: 69.7% из 879 голосов выбрали Avatar 6 Quality вместо Avatar V, и 64.3% из 863 голосов выбрали Avatar 6 Turbo вместо Avatar V Turbo. Голосования Quality против Turbo HeyGen не публиковал, поэтому официальной цифры, сколько вы теряете с Turbo, нет.
Что мы измерили в день запуска
Команда PoYo выполнила по одному текстовому запросу на каждой модели на продакшен-API 19 ноября 2026 года. Время — от отправки до результата для клиента, опрашивающего статус каждые несколько секунд, поэтому считайте его приблизительным.
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 s | 6.88 s |
| Стоимость по текущим ценам | 110 кредитов (11 s × 10) | 140 кредитов (7 s × 20) |
| Время | Около 2.4 min | Около 2 min |
Это два одиночных запуска с разными скриптами и аватарами, поэтому они не показывают, что Turbo быстрее или медленнее. Зато они показывают разницу в стоимости на практике: более длинный клип на Turbo всё равно стоил меньше, чем более короткий клип на Avatar 6. Они также показывают, что оба уровня работают минутами, так что ни один из них не является синхронным API, где можно ждать ответа на запрос. В любом случае планируйте опрос статуса или callback_url.
Какой ID модели HeyGen Avatar 6 API вызывать
| Ситуация | ID модели | Почему |
|---|---|---|
| Черновики, проверка скрипта и тайминга | heygen-avatar-6-turbo | Половина цены в 1080p; поля те же, поэтому одобренное тело запроса без изменений перезапускается на Avatar 6 |
| Персонализированные клипы в больших объёмах | heygen-avatar-6-turbo | В масштабе определяющим становится цена за секунду |
| Превью для пользователей в вашем приложении | heygen-avatar-6-turbo | Дешёвые итерации, пока пользователь пробует аватары и скрипты |
| Финальное видео с ведущим или брендовое видео | heygen-avatar-6 | Уровень Quality от HeyGen |
| Нужно 2K при ограниченном бюджете | heygen-avatar-6-turbo + 2K | 18 кредитов за секунду, дешевле Avatar 6 в 1080p |
| Финальный мастер в 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 в теле: 400 при проблеме с входными данными (аудио вне диапазона 2–60 s, неизвестное имя аватара, поля из двух режимов), 402 insufficient_credits_error при нехватке баланса, 429 при превышении лимита запросов и 5xx при временных сбоях. 400 на Turbo будет и 400 на Avatar 6, поэтому никогда не пытайтесь исправить ошибку валидации «повтором на другом уровне». Вместо этого исправьте входные данные.
Резервы действуют для обоих уровней сразу. Текстовые задачи на любой из моделей удерживают кредиты от отправки до расчёта, а сообщение 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 стоит 10 кредитов ($0.05) за секунду в 1080p против 20 ($0.10) и 18 ($0.09) в 2K против 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. Руководство text-to-avatar — недорогая точка старта.