HeyGen: как сделать видео с AI-аватаром — от первого ролика до агента в Claude Code

01Три уровня входа: студия, API и агент

HeyGen — не одна кнопка, а три разных сценария работы с одним и тем же движком. Понять, какой ваш, полезно до оплаты: от него зависит и тариф, и то, что вам вообще придётся настраивать.

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

02Тарифы: за что здесь платят

Студия работает на кредитах: кредит — внутренняя единица, которая тратится на генерацию видео, перевод, озвучку и работу моделей. Бесплатный тариф устроен иначе — он даёт не кредиты, а три видео в месяц.

• Кредиты ≠ минуты. Расход зависит от модели и типа задачи (аватар-видео, перевод, озвучка считаются по-разному), поэтому планируйте бюджет под свой сценарий, а не по «стоимости минуты».
• Перевод и липсинк — отдельные операции: на бесплатном тарифе они ограничены одной минутой, на платных — тридцатью.
• Разрешение и скорость — тоже товар: 4K и приоритетная обработка начинаются с Pro, командные функции и SSO — с Business.

03Первый ролик: путь от сценария до mp4

В студии всё сводится к пяти шагам, и первые три занимают больше времени, чем сама генерация.

04Аватары: стоковый, фото-аватар и цифровой двойник

В HeyGen три разных типа «лица», и путают их чаще всего. Разница в том, сколько материала вы отдаёте платформе и насколько живым получается результат.

Аватар IV — обученная на реальном видео модель: она воспроизводит мимику и держит голос, а на платных тарифах длительность одного ролика с ней доходит до 30 минут. Avatar V заявлен как развитие линейки — с сохранением внешности персонажа между роликами; в документации он относится к цифровым двойникам. Стоковые аватары дешевле и не требуют согласия модели, но «лицо бренда» с ними не построить.

05Голос, языки и перевод готового видео

Самая сильная часть HeyGen — не генерация «с нуля», а локализация. Вы загружаете готовое видео, платформа переводит речь на нужный язык, клонирует тембр спикера и подгоняет артикуляцию под новую дорожку. На платных тарифах заявлено 175 языков и диалектов против 30+ на бесплатном.

• Два режима перевода: «скорость» и «точность» — выбор влияет на время и на качество липсинка.
• Правка сценария доступна с тарифа Pro: без неё автоматический перевод уходит в рендер как есть.
• Отдельные инструменты — липсинк для чужого аудио и озвучка текста (TTS) без видео: вход до 5 000 знаков и скорость 0,5–2,0×.

06API: ключ, первый запрос, ожидание результата

API живёт на api.heygen.com, авторизация — заголовком X-Api-Key. Ключ создаётся в личном кабинете разработчика, а проверить его проще всего запросом о себе: GET /v3/users/me. Генерация асинхронная: запрос возвращает идентификатор задачи, дальше вы опрашиваете статус или ждёте вебхук.

export HEYGEN_API_KEY="ваш-ключ"

# 1. проверить ключ
curl -s "https://api.heygen.com/v3/users/me" -H "X-Api-Key: $HEYGEN_API_KEY"

# 2. попросить видеоагента собрать ролик по промпту
curl -X POST "https://api.heygen.com/v3/video-agents" \
  -H "X-Api-Key: $HEYGEN_API_KEY" -H "Content-Type: application/json" \
  -d '{"prompt": "Ведущий за 30 секунд объясняет запуск нашего продукта"}'

# 3. забрать результат: идентификатор сессии придёт в ответе, статус — GET по сессии

Что доступно через API — по документации (снято 05.10.2026):

07Агент: MCP-коннектор, CLI и навыки

Самый быстрый путь для тех, кто работает в Claude Code, Cursor, Codex или Gemini CLI: подключить HeyGen как MCP-коннектор. Ключ не нужен — авторизация через OAuth, а расход списывается с кредитов вашего тарифа.

# официальный CLI
heygen auth status
heygen video create --help

# навыки HeyGen в проект (Claude Code, Cursor, Codex, Gemini CLI)
npx skills add heygen-com/skills

Навыки — отдельная история: это три составных навыка (аватар, видео, перевод), которые передают агенту не только доступ к инструментам, но и экспертизу: правильные пропорции, работа с промптом, подбор голоса. Скиллы общаются между собой человекочитаемыми файлами AVATAR-<ИМЯ>.md в корне проекта, поэтому цепочка «создать аватара → снять ролик → перевести» собирается без склеивающего кода.

08HyperFrames: видео из HTML — открытый проект HeyGen

Отдельная и, пожалуй, самая недооценённая часть экосистемы: HyperFrames — open-source фреймворк, который превращает HTML, CSS и «перематываемые» анимации в детерминированный mp4. Формула, которую придумали авторы: «пиши HTML, получай видео; сделано для агентов».

Практический смысл для нас, а не для HeyGen: если у вас уже есть HTML-шаблоны отчётов или дашбордов, их можно отрендерить в видео без человека и без студии — графика, подписи и анимация делаются кодом, а результат получается одинаковым при каждом запуске. Для агентских пайплайнов это важнее, чем красивые аватары: рендер становится предсказуемым шагом, который можно проверять тестами.

09Лимиты, о которые спотыкаются на проде

Документация честно публикует ограничения — и именно они определяют, сработает ваш сценарий или упрётся в стену. Ниже — официальные значения на 05.10.2026.

• Публичные URL обязательны. Ссылки на файлы за авторизацией приводят к ошибке download_failed — файлы лучше грузить через API активов.
• Заголовок Retry-After — ваш друг. Он говорит, через сколько повторить, вместо слепых ретраев с фиксированной паузой.
• Один ролик — одна сцена имеет смысл, если вы не собираете многосценный монтаж: в простом режиме лимит длительности сцены становится лимитом всего видео.

10Стоит ли брать: короткий вывод

Коротко: HeyGen силён там, где нужно много говорящего видео с узнаваемым лицом и на разных языках. Если ваша задача — графика, титры и данные, дешевле и предсказуемее окажется HyperFrames; если нужен полностью закрытый контур — ни то, ни другое не подойдёт, потому что облачных ограничений здесь не обойти.