Параметр
promptобяз.Тип
text
Значения
text description
По умолчанию
required
Цена
—
GetVibeAPIТема
Язык
Видео
HeyGen Avatar V API — как подключиться и оплачивать
HeyGen Avatar V — новейший движок говорящих аватаров: готовый аватар HeyGen озвучивает вашу аудиодорожку с более естественными движениями и синхронизацией губ, чем Avatar IV. Требуются avatar (имя готового аватара HeyGen, например «Ann Doctor Standing») и audio_url; длительность ролика равна длительности аудио (до 5 минут). 720p / 1080p / 4K. Оплата за секунду выходного видео.
Создайте нужный результат
heygen-avatar-v:flowВ каталоге для этой модели указана только минимальная цена.
Ввод: Текст, АудиоДля некоторых режимов необходимо прикрепить: heygen avatar (ready-made avatar name), audio track
Что такое HeyGen Avatar V
HeyGen Avatar V — новейший движок говорящих аватаров: готовый аватар HeyGen озвучивает вашу аудиодорожку с более естественными движениями и синхронизацией губ, чем Avatar IV. Требуются avatar (имя готового аватара HeyGen, например «Ann Doctor Standing») и audio_url; длительность ролика равна длительности аудио (до 5 минут). 720p / 1080p / 4K. Оплата за секунду выходного видео.
Кратко о контракте
- Ввод
- text, audio
- Выход
- video
- Режим
- асинхронный (задание + опрос)
- Опрос статуса
- каждые 3 с · до 600 с
Преимущества
- Тарификация: за секунду
- Входные данные: текст, аудио
- 3 настраиваемых параметра
- Один API-ключ для генерации медиа
Где используется
- Клипы для социальных сетей
- Промоматериалы и заставки
- Анимация неподвижного изображения
- Раскадровки и аниматики
Контракт API
Генерация выполняется асинхронно: создайте задание, затем опрашивайте его статус до завершения.
- Создать задание
- POST /api/media/generate
- Проверить статус
- GET /api/media/jobs/{jobId}
- Ввод
- text, audio
- Выход
- video
- Опрос статуса
- каждые 3 с · до 600 с
- Аутентификация
- Authorization: Bearer sk-pv-…
Пример запроса
Передайте ключ в заголовке Bearer. API возвращает jobId для проверки статуса.
curl -sS https://getvibeapi.com/api/media/generate \
-H "Authorization: Bearer $GETVIBE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary '{"model":"heygen-avatar-v:flow","opts":{"avatar":"example","audio_url":"https://example.com/audio_url.mp3","resolution":"720p","aspect_ratio":"auto"}}'JavaScript
const response = await fetch('https://getvibeapi.com/api/media/generate', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.GETVIBE_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"model": "heygen-avatar-v:flow",
"opts": {
"avatar": "example",
"audio_url": "https://example.com/audio_url.mp3",
"resolution": "720p",
"aspect_ratio": "auto"
}
}),
});
if (!response.ok) throw new Error(`GetVibe API: ${response.status}`);
const { jobId } = await response.json();
console.log(jobId);Параметры запроса API
Параметры запросов к HeyGen Avatar V через GetVibe API.
Параметр
audio_urlТип
URL
Значения
Public audio URL
По умолчанию
—
Цена
—
Параметр
avatarобяз.Тип
text / number
Значения
any value
По умолчанию
—
Цена
Included in the base price
Параметр
resolutionТип
option selection
Значения
720p (default) · 1080p · 4K
По умолчанию
720p
Цена
Included in the base price
Параметр
aspect_ratioТип
option selection
Значения
Auto (default) · 16:9 · 9:16 · 4:5 · 5:4 · 1:1
По умолчанию
Авто
Цена
Included in the base price
Параметр
audio_file_idТип
text
Значения
Alternative to audio_url: the id of your own file from POST /v1/files (file-pv-…)
По умолчанию
—
Цена
Included in the base price
Параметр
audio_base64Тип
text
Значения
Alternative to audio_url: the file inline, as base64 or a data: URI
По умолчанию
—
Цена
Included in the base price
| Параметр | Тип | Значения | По умолчанию | Цена |
|---|---|---|---|---|
promptобяз. | text | text description | required | — |
audio_url | URL | Public audio URL | — | — |
avatarобяз. | text / number | any value | — | Included in the base price |
resolution | option selection | 720p (default) · 1080p · 4K | 720p | Included in the base price |
aspect_ratio | option selection | Auto (default) · 16:9 · 9:16 · 4:5 · 5:4 · 1:1 | Авто | Included in the base price |
audio_file_id | text | Alternative to audio_url: the id of your own file from POST /v1/files (file-pv-…) | — | Included in the base price |
audio_base64 | text | Alternative to audio_url: the file inline, as base64 or a data: URI | — | Included in the base price |
Запрос: POST https://getvibeapi.com/api/media/generate. Цены указаны в USD.
Цена HeyGen Avatar V
Стоимость HeyGen Avatar V: от $0.142857 per second. Цена рассчитывается динамически по текущему обменному курсу, а итоговая сумма списания указывается в ответе API (priceRub). Оплата в USD, без подписок.
Сколько стоит запрос по умолчанию
Если параметры не переданы, используются следующие значения: Resolution — 720p, Frame format — Auto. Стоимость такого запроса — $0.142857.
README
Машиночитаемый контракт для HeyGen Avatar V содержит схему запроса, операции, ограничения, примеры опроса и ответов.
# HeyGen Avatar V
Публичная модель: heygen-avatar-v:flow
Создать задание: POST /api/media/generate
Проверить статус: GET /api/media/jobs/{jobId}
## Входные параметры
- `prompt` (text): text description; по умолчанию: required
- `audio_url` (URL): Public audio URL; по умолчанию: —
- `avatar` (text / number): any value; по умолчанию: —
- `resolution` (option selection): 720p (default) · 1080p · 4K; по умолчанию: 720p
- `aspect_ratio` (option selection): Auto (default) · 16:9 · 9:16 · 4:5 · 5:4 · 1:1; по умолчанию: Auto
- `audio_file_id` (text): Alternative to audio_url: the id of your own file from POST /v1/files (file-pv-…); по умолчанию: —
- `audio_base64` (text): Alternative to audio_url: the file inline, as base64 or a data: URI; по умолчанию: —
## Публичные варианты
- `heygen-avatar-v:flow`: по умолчаниюЧасто задаваемые вопросы об API HeyGen Avatar V
Сколько стоит HeyGen Avatar V?
Цена HeyGen Avatar V: от $0.142857 per second. Цена рассчитывается динамически по текущему обменному курсу.
Совместим ли он с OpenAI SDK?
Да, API полностью совместим с OpenAI. Просто измените base_url на https://getvibeapi.com/v1 и укажите свой ключ — остальной код останется без изменений.
Подключите HeyGen Avatar V прямо сейчас
Регистрация занимает минуту, оплата по мере использования, готовый код уже выше.
Получить API-ключ