HeyGen Video 1.0 API
heygen-video-1-0 — генерация видео-модель от Heygen.
asyncimage_to_videotext_to_videovideo_to_video
Попробуйте прямо здесь
HeyGen Video 1.0 Открыть в песочнице
Что умеет HeyGen Video 1.0
- Async
- Видео из изображения
- Видео по тексту
- Video-to-Video
Стоимость
за секунду
480p text/frame
2.85 ₽
480p · 960x416
2.85 ₽
480p · 832x480
2.85 ₽
480p · 640x480
2.85 ₽
480p · 480x480
2.85 ₽
480p · 480x640
2.85 ₽
480p · 480x832
2.85 ₽
768p text/frame
4.27 ₽
768p · 1536x672
4.27 ₽
768p · 1344x768
4.27 ₽
768p · 1024x768
4.27 ₽
768p · 768x768
4.27 ₽
768p · 768x1024
4.27 ₽
768p · 768x1344
4.27 ₽
768p text/frame default
4.27 ₽
480p references
5.69 ₽
480p · 960x416 references
5.69 ₽
480p · 832x480 references
5.69 ₽
480p · 640x480 references
5.69 ₽
480p · 480x480 references
5.69 ₽
480p · 480x640 references
5.69 ₽
480p · 480x832 references
5.69 ₽
768p references
8.54 ₽
768p references default
8.54 ₽
768p · 1536x672 references
8.54 ₽
768p · 1344x768 references
8.54 ₽
768p · 1024x768 references
8.54 ₽
768p · 768x768 references
8.54 ₽
768p · 768x1024 references
8.54 ₽
768p · 768x1344 references
8.54 ₽
Цены указаны в рублях и списываются с баланса проекта за успешные запросы. Надбавки (+) суммируются с базовой ставкой.
Технические характеристики
Vendor
heygen
Modality
video
HeyGen Video 1.0 API для генерации видео
HeyGen Video 1.0 — универсальная модель американской компании HeyGen, представленная 30 сентября 2026 года. Она превращает текстовый запрос, изображение или референсное видео в короткий ролик со встроенным синхронным звуком: диалогами, атмосферой и эффектами. Модель выделяется универсальностью входных данных и подходит для рекламных сцен, продуктовых демонстраций и контента для соцсетей.
Параметры запроса
Параметры, которые принимает модель. Передаются в теле запроса.
ПараметрТипДиапазон / значенияПо умолчаниюОписание
positivePromptreqstring
min: 1 · max: 32000
—Описание сцены и звуков.
1 пример
Примеры
Куб неподвижно стоит на белом фоне.
widthinteger
—
—Парный к height; только combos. Несовместим с frameImages или resolution.
heightinteger
—
—Парный к width; те же ограничения.
resolutionenum
480p, 768p
—По умолчанию upstream 768p при входных медиа. Требует frameImages/referenceImages/referenceVideos; несовместим с width/height.
durationinteger
min: 5 · max: 15
5Длительность результата, секунды.
seedinteger
min: 0 · max: 4294967295
—Сид.
1 пример
Примеры
0
inputs.referenceImagesarray of strings
min: 1 · max: 9
—До 9 изображений по 16 MB. Всего до 12 референсов; несовместимы с frameImages.
1 пример
Примеры
[ "https://example.com/reference.png" ]
inputs.referenceVideosarray of strings
min: 1 · max: 3
—До 3 видео по 32 MB. Публичные URL без редиректов; длительность читается сервером для резерва. UUID недоступны для безопасной оценки. Всего до 12 референсов; несовместимы с frameImages.
inputs.referenceAudiosarray of strings
min: 1 · max: 3
—До 3 аудио по 32 MB, URL или UUID. Требует referenceImages или referenceVideos. Всего до 12 референсов; несовместимы с frameImages.
inputs.frameImagesarray of strings or objects
min: 1 · max: 1
—Ровно один первый кадр, до 16 MB. Несовместим с любыми референсами и width/height.
2 формата ввода
string[]
[ "https://example.com/frame.png" ]
object[]
| Поле | Тип | Значения | Описание |
|---|---|---|---|
imagereq | string | — | |
frame | enum | first, 0 |
[
{
"image": "https://example.com/frame.png",
"frame": "first"
}
]settings.promptEnhancementenum
disabled, turbo, quality
turboРасширение промпта.
outputTypeenum
URL
URLФормат доставки результата.
outputFormatenum
MP4, WEBM, MOV
MP4Формат файла.
outputQualityinteger
min: 20 · max: 99
95Качество сжатия.
numberResultsinteger
min: 1 · max: 4
1Количество результатов; цена умножается на количество.
safety.checkContentboolean
—
—Проверка безопасности контента.
safety.modeenum
fast, full
fastПроверка ключевых или всех кадров.
uploadEndpointstring
—
—URL загрузки результата через PUT.
1 пример
Примеры
https://storage.example.com/result
Поддерживаемые размеры
Допустимы только эти комбинации width × height. Произвольные значения вендор отклонит — используй resolution preset либо одну из пар ниже.
480p · 960x416
960×416480p · 832x480
832×480480p · 640x480
640×480480p · 480x480
480×480480p · 480x640
480×640480p · 480x832
480×832768p · 1536x672
1536×672768p · 1344x768
1344×768768p · 1024x768
1024×768768p · 768x768
768×768768p · 768x1024
768×1024768p · 768x1344
768×1344Пример кода
heygen-video-1-0_example.py
from openai import OpenAI
client = OpenAI(api_key="rk_live_...", base_url="https://api.ranvik.ru/v1")
resp = client.videos.generate(
model= "heygen-video-1-0",
positivePrompt= "Пример промпта",
width= 1,
height= 1,
resolution= "480p",
duration= 5,
seed= 2147483648,
outputType= "URL",
outputFormat= "MP4",
outputQuality= 95,
numberResults= 1,
uploadEndpoint= "value",
inputs= {
"referenceImages": [],
"referenceVideos": [],
"referenceAudios": [],
"frameImages": []
},
settings= {
"promptEnhancement": "turbo"
},
safety= {
"checkContent": False,
"mode": "fast"
},
)
print(resp)Частые вопросы о HeyGen Video 1.0
HeyGen Video 1.0 — универсальная модель HeyGen для генерации коротких видеороликов по текстовому запросу, изображению или референсному видео.
Модель нужна для промороликов, контента для соцсетей и демонстраций продукта: она создает видео и синхронный звук в рамках одного запроса.
API можно получить у HeyGen. Для работы с доступными ИИ-моделями через единый ключ используйте Ranvik API: сервис дает понятную документацию и быстрый старт.
Зарегистрируйтесь в Ranvik API, создайте проект и выпустите ключ. Сервис работает в России без VPN, а единый интерфейс упрощает подключение доступных моделей.
Да. Ranvik API поддерживает безопасную оплату в российских рублях и пополнение баланса; расчет идет по фактическому использованию ресурсов.
Для создания ролика можно задать текстовое описание, приложить изображение или референсное видео. Модель также генерирует диалоги, атмосферные звуки и эффекты.