guides

HeyGen Avatar 6 API: что такое HeyGen Avatar 6, ID моделей, режимы ввода, лимиты и цена

Poyo.ai Team
8 min read
Share:

HeyGen Avatar 6 API в PoYo: ID моделей, режимы ввода, лимиты и цена

HeyGen Avatar 6 API доступен в PoYo под двумя ID моделей: heygen-avatar-6 и уровень Turbo heygen-avatar-6-turbo, вдвое дешевле в 1080p. Обе модели превращают фото, референсное видео с анимированным персонажем или один из 1,248 публичных образов аватаров HeyGen в говорящий MP4 с синхронизацией губ в 1080p или 2K. Управляет ими ваше аудио, а для публичных аватаров также текст. Попробовать оба уровня можно на странице модели HeyGen Avatar 6, прежде чем писать код.

В этом обзоре: что выпустил HeyGen, формат запроса в PoYo, лимиты, которые должен проверять ваш код, цена за секунду и что мы измерили в день запуска.

Что такое HeyGen Avatar 6?

HeyGen Avatar 6 — это видеомодель HeyGen для говорящих аватаров. В техническом отчёте HeyGen от 17 ноября 2026 года сказано, что «Avatar 6 воспроизводит, как человек выглядит, говорит и двигается, в разрешении до 2K», и что модель работает «по одной фотографии». HeyGen описывает два уровня, Avatar 6 Quality и Avatar 6 Turbo; в PoYo это heygen-avatar-6 и heygen-avatar-6-turbo.

ДатаЧто произошло
17 ноября 2026HeyGen публикует технический отчёт об Avatar 6
19 ноября 2026Оба уровня доступны в PoYo как heygen-avatar-6 и heygen-avatar-6-turbo

Три заявления HeyGen важны для интеграции, потому что они соответствуют полям запроса:

  • Нативное 2K. HeyGen утверждает, что «каждый кадр [генерируется] в 2880×1620». В PoYo это выбирается через "resolution": "2K".
  • Промпты движений. В отчёте HeyGen сказано: «Напишите действие рядом со словами. Avatar 6 выполнит его точно в нужный момент». В PoYo это поле prompt, до 1,200 символов.
  • Предпочтение перед Avatar V. В онлайн-голосовании HeyGen 69.7% из 879 голосов выбрали Avatar 6 Quality вместо Avatar V, и 64.3% из 863 голосов выбрали Avatar 6 Turbo вместо Avatar V Turbo. Это собственные данные HeyGen.

HeyGen Avatar 6 API кратко

Параметрheygen-avatar-6heygen-avatar-6-turbo
Уровень HeyGenAvatar 6 QualityAvatar 6 Turbo
Эндпоинт отправкиPOST https://api.poyo.ai/api/generate/submitТот же
РезультатGET /api/generate/status/{task_id} или callback_urlТот же
Режимы вводаФото, референсное видео, публичный аватарТе же три
ВыводОдин MP4, 1080p (по умолчанию) или 2KТо же
Речевой вводАудио 2–60 s или текст до 1,000 символов (только публичный аватар)То же
Цена, 1080p20 кредитов ($0.10) за секунду10 кредитов ($0.05) за секунду
Цена, 2K29 кредитов ($0.145) за секунду18 кредитов ($0.09) за секунду

Поля запроса идентичны, поэтому для смены уровня достаточно поменять строку model. Правила для полей описаны в документации PoYo по HeyGen Avatar 6.

Три режима ввода, один эндпоинт

Поля mode нет. Режим определяется переданными входными данными, в таком порядке:

РежимВыбирается, когдаВходные данныеСоотношение сторон
Публичный аватарЕсть avataravatar + text (+ опционально voice) или avatar + audio_urlaspect_ratio: 16:9 (по умолчанию), 9:16, 1:1, 4:5, 5:4
Референсное видеоЕсть video_url (и нет avatar)video_url + audio_url, опционально одно фото в image_urlsКак у входного видео
ФотоПо умолчаниюimage_urls (ровно одно) + audio_urlКак у входного фото

prompt и resolution работают в любом режиме. aspect_ratio и voice относятся только к режиму публичного аватара. В одном запросе передавайте входные данные одного режима. Собственная документация HeyGen для разработчиков разделяет эту работу на два отдельных API (API модели для изображения или видео плюс аудио и API приложения для образов аватаров HeyGen); в PoYo для обоих случаев используется одна форма запроса.

Режим референсного видео предназначен для анимированных или нарисованных персонажей. Для реального человека используйте режим фото с одной фотографией.

Лимиты, которые нужно проверить перед отправкой

ПолеПравило
image_urlsРовно один URL; используется image_urls[0]
video_urlНе менее 2 секунд, до 50 MB
audio_url2–60 секунд, до 15 MB; видео длится столько же, сколько аудио
text1–1,000 символов (режим публичного аватара, вместо audio_url)
avatarОдно из 1,248 имён (156 человек); регистр букв и лишние пробелы игнорируются
voiceОдно из 102 имён; по умолчанию Warm Pro Narrator
promptДо 1,200 символов
resolution1080p или 2K

Все URL медиафайлов должны быть публичными и напрямую скачиваемыми по HTTP или HTTPS. PoYo проверяет длину аудио, длину референсного видео и имя аватара при отправке, поэтому некорректные входные данные отклоняются сразу, а не после ожидания. Результат может быть примерно на десятую долю секунды короче аудио. Все имена аватаров и голосов есть на странице Avatars and Voices вместе со скачиваемым JSON-каталогом.

Цены HeyGen Avatar 6 API в PoYo

PoYo тарифицирует каждую секунду вывода в кредитах (1 кредит = $0.005):

Модель1080p за секунду2K за секунду10 s в 1080p60 s в 1080p
heygen-avatar-6-turbo10 кредитов ($0.05)18 кредитов ($0.09)100 кредитов ($0.50)600 кредитов ($3.00)
heygen-avatar-620 кредитов ($0.10)29 кредитов ($0.145)200 кредитов ($1.00)1,200 кредитов ($6.00)

Тарифицируемые секунды округляются вверх до целых. С audio_url списание зависит от длины аудио и происходит при отправке. С text PoYo резервирует кредиты при отправке и рассчитывается по длине готового видео, когда задача завершается. Полный разбор с примерами расчётов — в статье Цены HeyGen Avatar 6 API.

Результаты тестов в день запуска

Команда PoYo провела эти тесты на продакшен-API 19 ноября 2026 года в режиме публичного аватара с текстом. Время — от отправки до результата с точки зрения клиента, опрашивающего статус, поэтому считайте его приблизительным.

МодельАватар / голосСкриптРезультатСтоимость по текущим ценамВремя
heygen-avatar-6-turboAbigail Office Front / Jessica Anne Bogart27 слов, 16:9, 1080p10.16 s110 кредитов (11 s × 10)Около 2.4 min
heygen-avatar-6Bryan Tech Expert / Andrew21 слово, 16:9, 1080p6.88 s140 кредитов (7 s × 20)Около 2 min

Две минуты и больше на короткий клип означают, что это асинхронный API: отправьте запрос, сохраните task_id и опрашивайте статус или получайте callback. Не держите открытым HTTP-запрос пользователя, пока задача выполняется.

HeyGen Avatar 6 API: быстрый старт

Это пример из документации для режима публичного аватара с текстом:

curl https://api.poyo.ai/api/generate/submit \
  -H "Authorization: Bearer $POYO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "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",
      "prompt": "Speak with calm confidence and nod slightly at the end.",
      "aspect_ratio": "16:9",
      "resolution": "1080p"
    }
  }'

Проверьте code в теле ответа (он должен быть 200), сохраните data.task_id, затем вызывайте GET https://api.poyo.ai/api/generate/status/{task_id}, пока status не станет finished, и заберите MP4 из data.files[].file_url. Сгенерированные видео доступны 3 дня, поэтому копируйте их в своё хранилище. Режим фото, режим референсного видео, ограниченный цикл на Python и обработка ошибок описаны в руководстве по HeyGen Avatar 6 API.

Какие запросы подходят для HeyGen Avatar 6 API

Что нужноВызов
Видео с ведущим по скрипту, без аудиофайлаheygen-avatar-6 или -turbo в режиме публичного аватара (руководство text-to-avatar)
Фото реального человека, произносящего ваше аудио, в 1080p или 2KРежим фото
Говорящий маскот или мультипликационный персонажРежим референсного видео
Черновики, превью, большие объёмыheygen-avatar-6-turbo (см. Avatar 6 vs Turbo)
Минимальная цена за секунду из фото плюс аудиоСравните с Kling Avatar 2.0
Аудио длиннее 60 секундOmniHuman 2.0 принимает 4–300 s аудио в 720p, 21 кредит за секунду

Часто задаваемые вопросы

Какие ID моделей у HeyGen Avatar 6 API?

heygen-avatar-6 (уровень Avatar 6 Quality от HeyGen) и heygen-avatar-6-turbo. Обе используют POST https://api.poyo.ai/api/generate/submit с одинаковыми полями input.

Сколько стоит HeyGen Avatar 6 API?

В PoYo, за секунду вывода: Turbo 10 кредитов ($0.05) в 1080p и 18 кредитов ($0.09) в 2K; Avatar 6 20 кредитов ($0.10) в 1080p и 29 кредитов ($0.145) в 2K. Секунды округляются вверх.

Может ли HeyGen Avatar 6 API сделать видео только из текста?

Да, в режиме публичного аватара. Отправьте avatar и до 1,000 символов text, плюс опционально voice из 102 доступных голосов. Режимам фото и референсного видео нужен audio_url.

Какой длины может быть видео из HeyGen Avatar 6 API?

С аудио — 2–60 секунд, по длине аудио. С текстом видео длится столько, сколько аватару нужно, чтобы прочитать до 1,000 символов.

Какие разрешения поддерживает HeyGen Avatar 6 API?

1080p (по умолчанию) и 2K. Режим публичного аватара добавляет aspect_ratio (16:9, 9:16, 1:1, 4:5, 5:4); остальные режимы сохраняют соотношение сторон входных данных.

Поддерживает ли HeyGen Avatar 6 API вебхуки?

Да. Добавьте callback_url на верхнем уровне, и PoYo отправит результат задачи, когда она будет finished или failed. Можно также опрашивать эндпоинт статуса.

Share: