Характеристики Avatar IV
Контекстное окно —
Дата релиза 24 августа 2026
Мультимодальность
Входящие данные:
- Текст
- Изображения
- Аудио
Исходящие данные:
- Видео
Цены Avatar IV в рублях
Оплата производится по факту за каждую секунду сгенерированного видео.
Тип
Стоимость
Видео
5,65 ₽
/ 1 секунду видео
Цены указаны в рублях и могут меняться в зависимости от курса валют
Что умеет Avatar IV
HeyGen: Avatar IV — это модель преобразования изображения в видео, которая анимирует одну фотографию в выразительное видео говорящей головы с синхронизацией губ. Вместо того чтобы просто сопоставлять формы рта со словами, она интерпретирует вокал…
API Avatar IV: подключение и примеры кода
Наш сервис предоставляет единый API, совместимый с OpenAI SDK. Просто укажите наш base_url и используйте ключ, полученный в личном кабинете.
import requests
import json
url = "https://routerai.ru/api/v1/videos"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
}
# Генерация видео асинхронная: создаём задачу и получаем её id
data = {
"model": "heygen/avatar-iv",
"prompt": "Привет! Рады видеть вас на нашей платформе.",
"aspect_ratio": "16:9",
"resolution": "720p",
# Референсы: изображения (персонаж/стиль)
"input_references": [
{"type": "image_url",
"image_url": {"url": "https://example.com/reference.jpg"}}
],
# Вариант 1: голос из каталога — provider.options.heygen.voice_id (для русского — мультиязычные, напр. Kore/Orus; полный каталог — GET /v3/voices HeyGen). Фото в input_references — только JPEG с различимым лицом.
"provider": {"options": {"heygen": {"voice_id": "80441555167a467e967ab9487d844a30"}}}
}
response = requests.post(url, headers=headers, json=data)
result = response.json()
print(json.dumps(result, indent=2, ensure_ascii=False))
# В ответе: id, status, polling_url
# Далее: опрос статуса GET /v1/videos/{id} и скачивание mp4
# GET /v1/videos/{id}/content — см. документацию
# Вариант 2: озвучка из готовой аудиодорожки (липсинк) — voice_id не нужен:
# data = {
# "model": "heygen/avatar-iv",
# "prompt": "Дружелюбно улыбается и жестикулирует в такт речи",
# "input_references": [
# {"type": "image_url", "image_url": {"url": "https://example.com/reference.jpg"}},
# {"type": "audio_url", "audio_url": {"url": "https://example.com/speech.wav"}}
# ]
# }
# Генерация видео асинхронная: создаём задачу, в ответе придут id и polling_url.
# Поллинг статуса (GET /v1/videos/{id}) и скачивание mp4
# (GET /v1/videos/{id}/content) — см. документацию.
# Поддерживаются референсы (input_references): изображения (персонаж/стиль) — URL или data URI в base64.
# Вариант 1: голос из каталога — provider.options.heygen.voice_id (для русского — мультиязычные, напр. Kore/Orus; полный каталог — GET /v3/voices HeyGen). Фото в input_references — только JPEG с различимым лицом.
curl -X POST "https://routerai.ru/api/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "heygen/avatar-iv",
"prompt": "Привет! Рады видеть вас на нашей платформе.",
"aspect_ratio": "16:9",
"resolution": "720p",
"input_references": [
{"type": "image_url",
"image_url": {"url": "https://example.com/reference.jpg"}}
],
"provider": {"options": {"heygen": {"voice_id": "80441555167a467e967ab9487d844a30"}}}
}'
# Вариант 2: озвучка из готовой аудиодорожки (липсинк) — voice_id не нужен
curl -X POST "https://routerai.ru/api/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "heygen/avatar-iv",
"prompt": "Дружелюбно улыбается и жестикулирует в такт речи",
"input_references": [
{"type": "image_url",
"image_url": {"url": "https://example.com/reference.jpg"}},
{"type": "audio_url",
"audio_url": {"url": "https://example.com/speech.wav"}}
]
}'
Эндпоинт API
Videos
Создаёт асинхронную задачу генерации видео: возвращает задачу со статусом и polling_url, результат опрашивается до готовности.
POST
Документация
https://routerai.ru/api/v1/videos
Поддерживаемые параметры запроса
Параметр
Тип
По умолчанию
Описание
aspect_ratio
string
—
Соотношение сторон видео. Доступные значения: 16:9, 9:16, 1:1.
resolution
string
—
Разрешение видео. Доступные значения: 720p, 1080p.
input_references
array
—
Референсы: изображения (персонаж, стиль, объект) и аудио (звуковая дорожка). Массив объектов {"type": "image_url", "image_url": {"url": …}} / {"type": "audio_url", "audio_url": {"url": …}}. URL или data URI в base64.
generate_audio
boolean
false
Генерировать ли аудиодорожку.
voice_id
—
Голос озвучки текста prompt. Обязателен при текстовом prompt (альтернатива — готовая аудиодорожка audio_url в input_references, тогда voice_id не нужен); передаётся только во вложенном объекте {"provider": {"options": {"heygen": {"voice_id": …}}}} — в корне тела не работает. Базовые голоса: Cassidy — 16a09e4706f74997ba4ed05ea11470f6 (английский, женский); Andrew — 6be73833ef9a4eb0aeee399b8fe9d62b (английский, мужской); Amelia — 246cdbf530954380a62109f3107fce0d (испанский, женский); Antonio — 707365599f8545d5b6ce7a32a20e9c93 (испанский, мужской); Chloe — 4b1de1582d2c477485ad2e0c2717f0ff (французский, женский); Thomas — 29b464727cc249f3bdf42f82562409f8 (французский, мужской); Leonie — 5d25200b1d4442d6b7265a9ff5fad582 (немецкий, женский); Otto — 0971fe1493314d1f9a43602cf4a3b210 (немецкий, мужской); Kyoko — 926a3d25100b4687a80fc76ec8f2bf38 (японский, женский); Satoshi — 662e1397965c484e8f65fa58c77effde (японский, мужской); Kore — 80441555167a467e967ab9487d844a30 (мультиязычный, женский); Orus — 3097f9a8fd3b4340b6bbe913177b378f (мультиязычный, мужской). Для русской речи подходят мультиязычные Kore и Orus. Полный каталог — GET /v3/voices HeyGen (нужен ключ HeyGen).
voice_settings
—
Настройки голоса озвучки: объект {"speed": 0.5–1.5, "pitch": −50…50, "volume": 0–1}, все поля необязательны. Замедление речи удлиняет ролик — и пропорционально его посекундную стоимость. Опция HeyGen Avatar IV — передаётся вложенно: {"provider": {"options": {"heygen": {"voice_settings": …}}}}.
motion_prompt
—
Текстовое описание движения и мимики персонажа. Опция HeyGen Avatar IV — передаётся вложенно: {"provider": {"options": {"heygen": {"motion_prompt": …}}}}.
expressiveness
—
Выразительность анимации персонажа: "low", "medium" или "high". Опция HeyGen Avatar IV — передаётся вложенно: {"provider": {"options": {"heygen": {"expressiveness": …}}}}.
fit
—
Способ вписывания исходного фото в кадр: "cover" — заполнить с обрезкой (поведение по умолчанию), "contain" — вписать целиком с полями. Опция HeyGen Avatar IV — передаётся вложенно: {"provider": {"options": {"heygen": {"fit": …}}}}.
remove_background
—
Убрать фон исходного фото; в паре с background — заменить на свой. Опция HeyGen Avatar IV — передаётся вложенно: {"provider": {"options": {"heygen": {"remove_background": …}}}}.
background
—
Фон видео: объект {"type": "color", "value": "#RRGGBB"} либо {"type": "image", "url": …} (data-URI не принимается). Работает только вместе с remove_background: true — без него игнорируется. Фон-картинка накладывается в границах исходного фото и растягивается под его пропорции; область кадра за пределами фото заливается белым — для полного покрытия соотношение сторон фото, фона и ролика должно совпадать. Опция HeyGen Avatar IV — передаётся вложенно: {"provider": {"options": {"heygen": {"background": …}}}}.
caption
—
Субтитры произносимого текста: объект {"file_format": "srt", "style": "default"} (единственные поддерживаемые значения). Ссылку на srt-файл API сейчас не возвращает, в кадр субтитры не вжигаются. Опция HeyGen Avatar IV — передаётся вложенно: {"provider": {"options": {"heygen": {"caption": …}}}}.
title
—
Название ролика. Опция HeyGen Avatar IV — передаётся вложенно: {"provider": {"options": {"heygen": {"title": …}}}}.