HeyGen
HeyGen Avatar V
heygen-avatar-v
Создайте многоразовый цифровой аватар реального человека на основе примерно 15-секундного референсного видео, переносите движения и жесты на новый сценарий и сцены, сохраняя согласованность между сценами
Попробовать heygen-avatar-v
Ввод
Работы
Все работыВывод
videoЦены
heygen-avatar-v per second
| Цена за единицу | $0.150 |
|---|
Описание позиционирования
heygen-avatar-v — это модель цифрового аватара от HeyGen, управляемая видео-референсом: из примерно 15-секундного видео с реальным человеком извлекаются особенности лица, движений и жестов, которые затем переносятся на новый сценарий, одежду, сцену, ракурс камеры и язык, создавая высокоразрешённое видео аватара с возможностью продления длины. Модель подходит командам, которым нужно стабильное появление одного и того же человека в обучении, маркетинге, продажах и локализованном контенте, а не одноразовая анимация по фото или вымышленный персонаж.
Ключевые преимущества
- Моделирование по видео-референсу, единая идентичность в разных сценах — особенности идентичности извлекаются из полного видеоконтекста, а не из одного кадра, что снижает дрейф при переносе на разные образы и сцены.
- Реалистичные движения и жесты переносятся вместе с идентичностью — исполнение берётся из реального движения в видео-референсе, что повышает естественность при генерации говорящего видео.
- Двойное управление: текст или аудио — можно ввести текст сценария, и встроенный синтез речи озвучит его, либо загрузить аудио для синхронизации губ, переключая рабочий процесс по необходимости.
- Один аватар — многократное использование — один и тот же аватар можно применять к новым сценариям, одежде, ракурсам и языкам, сокращая затраты на повторные съёмки и постобработку выравнивания.
Описание возможностей
Создание многоразового аватара по видео-референсу: из примерно 15-секундного видео с реальным человеком изучаются особенности лица и движений, формируется цифровой аватар для повторных вызовов, и последующая генерация не требует повторного сбора материалов.
Генерация говорящего видео по тексту: введите сценарий длиной до 5000 символов и выберите голос — модель выполнит синтез речи и генерацию исполнения, сразу выдавая видеофайл с синхронизацией губ.
Синхронизация губ по аудио: достаточно указать HTTPS-адрес аудио, чтобы управлять губами аватара; длина аудио — до 600 секунд; параметры сценария и голоса при этом не действуют, что подходит командам с уже готовыми озвучками.
Управление параметрами изображения и форматом выдачи: поддерживаются разрешения 720p, 1080p, 4k, соотношения сторон 16:9, 9:16, 4:5, 5:4, 1:1 и др., можно менять фон на однотонный или изображение, удалять фон, выводить mp4 или webm.
Сопроводительный файл субтитров: при включении опции субтитров вместе с видео возвращается SRT-файл субтитров, что удобно для последующей публикации на платформах или замены многоязычных субтитров.
Сценарии применения
- Команды корпоративного обучения: сценарии курсов + единый аватар лектора — пакетная генерация обучающих видео с одним лектором, образ которого остаётся единым в серии курсов, для прямой загрузки на внутреннюю платформу обучения.
- Маркетинг и продажи: сценарии продуктовых выступлений + брендовый аватар — быстрое создание нескольких версий говорящего контента с человеком, с переключением соотношения сторон и фона под канал, для публикации в соцсетях и страниц сопровождения продаж.
- Команды локализации: готовая озвучка + тот же аватар — озвучка на разных языках управляет губами одного и того же аватара, создавая многоязычные версии видео и снижая затраты на повторные съёмки.
- Внешние коммуникации: образ руководителя + официальный текст выступления — по видео-референсу руководителя создаётся аватар, по тексту генерируются обращения к аудитории и видео в роли бренд-амбассадора, сохраняя единый образ при многократных публикациях.
Ограничения и рекомендации по выбору
Модель требует видео-референс с реальным человеком в качестве входных данных идентичности и не может запускаться по одной фотографии; для одноразовой анимации по фото или вымышленных персонажей следует выбирать другие модели. Генерация тарифицируется по секундам выходного видео, поэтому для длинных видео стоимость нужно рассчитывать заранее. При использовании аватара реального человека следует получить явное письменное разрешение и управлять правами доступа к аккаунту. Если нужна лёгкая анимация говорящего по фото или нереалистичный образ, рекомендуется использовать более подходящую линейку, например Avatar IV.
Новости
Смотреть changelog →- Новая модель Новая модель: heygen-avatar-v, поддерживает генерацию видео с цифровым аватаром по тексту реплики с предустановленным голосом или управляющим аудио; доступно 497 образов цифровых аватаров…
Создать задачу генерации
https://api.hiapi.ai/v1/tasks Заголовки
AuthorizationstringОбязательноAPI-ключ аккаунта. Обязателен в каждом запросе. Пример: Bearer YOUR_HIAPI_API_KEY. Получить API-ключ
Content-TypestringНеобязательноТело запроса всегда разбирается как JSON; при отправке принимается только application/json (charset опционален) — любое иное значение возвращает 415. Пример: application/json.
Idempotency-KeystringНеобязательноКлюч идемпотентности, до 255 байт. Повторные запросы с тем же ключом того же аккаунта создают задачу лишь один раз; реплеи возвращают исходный taskId.
При сетевых таймаутах или автоповторах клиента один и тот же ключ создаёт задачу только один раз, без двойного списания (область = аккаунт API-ключа). Рекомендуется бизнес-уникальный идентификатор (напр. "order-42"); реплеи возвращают исходный taskId, ключ истекает через 24 часа после первого запроса. Полная матрица сценариев — во введении единого асинхронного API.
Тело запроса
modelstringОбязательноТекущее фиксированное значение: heygen-avatar-v
routestringНеобязательноТекущее фиксированное значение: default
inputobjectОбязательно
Объект бизнес-параметров для heygen-avatar-v и маршрута default — см. таблицу параметров ниже.
fitstringНеобязательноПо умолчанию: "cover"Управляет способом подгонки изображения аватара, строковый тип, по умолчанию cover.
containcovervoicestringНеобязательноПо умолчанию: "Warm Pro Narrator"minLength 1Указывает название тембра голоса для синтеза речи, строковый тип, по умолчанию Warm Pro Narrator; при передаче audio_url этот параметр игнорируется.
Warm Pro NarratorChill BrianIvyJohn DoeMonika SogamHope Archer BrittneyПоказать все (94)
PatrickDavid CastlemoreMichael CAdam Stone JuniperCassidy Jessica Anne BogartArabellaAndrewSpuds Oxley Grace ElderHelenCanyon RiversDerya - Lifelike - ExcitedMellow MarcusJack Sterling - BroadcasterBrenda - UGC - 1.mp4ReidReaganTerryJennyRadio RickDeniseTim in car - ExcitedIskanderThompsonDelicate Daisy - ExcitedKingstonGeorge UGC 1Bold BlakeJaneExpressive EvanMarianne - IAAaronModern Recipe Host - Voice 1WillowCute Chloe - FriendlyRafaelJune - LifelikeCrisp ChloeSlick SimonNassim - InformativeBaritone BenMaxwellEllie Faye - ExcitedMilaniFeisty Fiona - ExcitedProfessor DeanRose - UGC - 1.mp4ShonaHudson WilderAnn - IAAlastair KensingtonOxleyChristinaAndrew Rizz PeytonGerardo - OutdoorChloe - LifelikeStephanieAnthony - IASignal - Voice 1LucaLisa - Voice 1T.W.TuckerJack Sullivan - SeriousWinterMireia - LifelikeGeorgiaStellaMasha - LifelikeCharming Charles - FriendlySerenityAnnie - ExcitedRalphBethanyDominicMason FinnLeenaVeteran VictorTamaraNik PublicCalm ChloeSevikReillyRaulImposing IanRelaxed RayDexter - ProfessionalRelaxed RickEdwinRupert BlackwoodGinnyHopeavatarstringНеобязательноПо умолчанию: "Abigail Sofa Front"minLength 1Указывает название предустановленного аватара Avatar V, строковый тип, по умолчанию Abigail Sofa Front.
Abigail Office FrontAbigail Office SideAbigail Sofa FrontAbigail Sofa SideAmelia Business Training Front 2Amelia Business Training FrontAmelia Business Training Side 2Amelia Business Training SideПоказать все (489)
Amelia Lounge Front 2Amelia Lounge FrontAmelia Lounge Side 2Amelia Lounge SideAmelia Yoga Front 2Amelia Yoga FrontAmelia Yoga Side 2Amelia Yoga SideAnja Office FrontAnja Office Side Anja Sofa FrontAnja Sofa Side Ann Doctor SittingAnn Doctor StandingAnn TherapistAnnie Bar Sitting FrontAnnie Bar Sitting SideAnnie Bar Standing Front 2Annie Bar Standing Front 3Annie Bar Standing FrontAnnie Bar Standing Side 2Annie Bar Standing Side 3Annie Bar Standing SideAnnie Business Casual Standing Front 2Annie Business Casual Standing FrontAnnie Business Casual Standing Side 2Annie Business Casual Standing SideAnnie Casual Sitting Front 2Annie Casual Sitting FrontAnnie Casual Sitting Side 2Annie Casual Sitting SideAnnie Casual Standing Front 2Annie Casual Standing FrontAnnie Casual Standing Side 2Annie Casual Standing SideAnnie Desk Sitting Front 2Annie Desk Sitting FrontAnnie Desk Sitting Side 2Annie Desk Sitting SideAnnie Lounge Standing FrontAnnie Lounge Standing SideAnnie Office Sitting Front 2Annie Office Sitting FrontAnnie Office Sitting Side 2Annie Office Sitting SideAnnie Office Standing FrontAnnie Office Standing SideAnnie Sofa Sitting Front 3Annie Sofa Sitting FrontAnnie Sofa Sitting Side 2Annie Sofa Sitting Side 3Annie Sofa Sitting SideAnnie Sofa Sitting Front 2Annie Studio Pink Sitting FrontAnnie Studio Pink Sitting SideAnnie Studio Pink Standing FrontAnnie Studio Pink Standing SideArtur Office Front 2Artur Office FrontArtur Office Side 2Artur Office SideArtur Sofa Casual Front 2Artur Sofa Casual FrontArtur Sofa Casual Side 2Artur Sofa Causal SideAubrey Sofa SideAubrey Night Scene FrontAubrey Outdoor Sport FrontAubrey Outdoor Sport SideAubrey Sofa FrontBlanka Lounge FrontBlanka Lounge SideBlanka Outdoor Business FrontBlanka Outdoor Business SideBlanka Outdoor Reading FrontBlanka Outdoor Reading SideBlanka Picnic FrontBlanka Picnic SideBojan Business Training Front 2Bojan Business Training FrontBojan Business Training Side 2Bojan Business Training SideBojan Lounge Front 2Bojan Lounge FrontBojan Lounge Side 2Bojan Lounge SideBojan Sport Front 2Bojan Sport FrontBojan Sport Side 2Bojan Sport SideBrandon Business Sitting FrontBrandon Business Sitting SideBrandon Business Standing FrontBrandon Business Standing SideBrandon Casual Sitting FrontBrandon Casual Sitting SideBrandon Kitchen Standing FrontBrandon Kitchen Standing SideBrandon Lobby Sitting FrontBrandon Lobby Sitting SideBrandon Lobby Standing FrontBrandon Lobby Standing SideBrandon Office Sitting FrontBrandon Office Sitting SideBrandon Office Standing FrontBrandon Office Standing SideBrandon Sofa Sitting FrontBrandon Sofa Sitting SideBrent Office Front 2Brent Office FrontBrent Office Side 2Brent Office SideBrent Sofa Front 2Brent Sofa FrontBrent Sofa Side 2Brent Sofa SideBryan Fitness CoachBryan Tech ExpertCaroline Business Sitting FrontCaroline Business Sitting SideCaroline Business Standing FrontCaroline Business Standing SideCaroline Casual Sitting FrontCaroline Casual Sitting SideCaroline Kitchen Standing FrontCaroline Kitchen Standing SideCaroline Lobby Sitting FrontCaroline Lobby Sitting SideCaroline Lobby Standing FrontCaroline Lobby Standing SideCaroline Office Sitting FrontCaroline Office Sitting SideCaroline Office Standing FrontCaroline Office Standing SideCaroline Sofa Sitting FrontCaroline Sofa Sitting SideChloe Lounge FrontChloe Lounge SideChloe Outdoor SideConrad House FrontConrad House SideConrad Sofa FrontConrad Sofa SideDerya Indoor Front 2Derya Indoor FrontDerya Indoor Side 2Derya Indoor SideDerya Office Front 2Derya Office FrontDerya Office Side 2Derya Office SideDexter Doctor SittingDexter Doctor StandingDexter LawyerElenora Fitness CoachElenora Fitness Coach 2Elenora Tech ExpertEmanuel Office FrontEmanuel Office SideEmanuel Sofa FrontEmanuel Sofa SideEmilia Outdoor Business FrontEmilia Outdoor Business SideEmilia Outdoor Yoga Front 2Emilia Outdoor Yoga FrontEmilia Outdoor Yoga SideEmilia Picnic FrontEmilia Picnic SideFernando Business Indoor FrontFernando Business Indoor SideFernando OutdoorChair Front 2Fernando Outdoor Chair FrontFernando Outdoor Chair SideFernando Outdoor FrontFernando Outdoor SideFernando Outdoor Table FrontFernando Outdoor Table SideGala Bedroom FrontGala Business Sofa Front 2Gala Business Sofa Front 3Gala Business Sofa FrontGala Business Sofa Side 2Gala Business Sofa Side 3Gala Business Sofa SideGala Casual Sofa with iPad FrontGala Casual Sofa with iPad Side 2Gala Casual Sofa with iPad SideGala Office FrontGala Office SideGala Sofa Front 2Gala Sofa Front 3Gala Sofa FrontGala Sofa Side 2Gala Sofa Side 3Gala Sofa SideGeorgia Casual FrontGeorgia Casual SideGeorgia Office FrontGeorgia Office SideGerardo Sofa SideGerardo Indoor FrontGerardo Indoor SideGerardo Night Scene Front 2Gerardo Night Scene FrontGerardo Outdoor Sport FrontGerardo Outdoor Sport SideGerardo Sofa FrontGiulia Office Front 2Giulia Office FrontGiulia Office Side 2Giulia Office SideGiulia Sofa FrontGiulia Sofa SideGiulia Sofa Front 2Giulia Sofa Side 3Ida Lounge Front 2Ida Lounge FrontIda Lounge Side 2Ida Lounge SideIda Sofa Front 2Ida Sofa FrontIda Sofa Side 2Ida Sofa SideJocelyn Office Front 2Jocelyn Office FrontJocelyn Office Side 2Jocelyn Office SideJocelyn Sofa Front 2Jocelyn Sofa FrontJocelyn Sofa Side 2Jocelyn Sofa SideJoel Couch FrontJoel Couch SideJoel Gym FrontJoel Gym SideJoel Mountain FrontJoel Mountain SideJonas Gym Front 2Jonas Gym FrontJonas Gym Side 2Jonas Gym Side June Office Front 2Juan Office FrontJuan Office Side 2Juan Office SideJuan Sofa Front 2Juan Sofa FrontJuan Sofa Side 2Juan Sofa SideJudita Yoga Front 2Judita Yoga FrontJudita Yoga Side 2Judita Yoga SideJudy Doctor SittingJudy Doctor StandingJudy LawyerJudy Teacher SittingJudy HRJudy Teacher StandingJune HRJune Office FrontJune Office Side 2June Office SideJune Sofa Casual Front 2June Sofa Casual FrontJune Sofa Casual Side 2June Sofa Casual SideKavya Indoor FrontKavya Indoor SideKavya Outdoor SideKavya Outdoor Sport FrontKavya Outdoor Sport SideKavya Sofa FrontKavya Sofa SideLeos Office Front 2Leos Office FrontLeos Office Side 2Leos Office SideLeos Sofa Front 2Leos Sofa FrontLeos Sofa Side 2Leos Sofa SideLeszek Lounge FrontLeszek Lounge SideLeszek Outdoor Business FrontLeszek Outdoor Business SideLeszek Outdoor Casual FrontLeszek Outdoor Casual SideLeszek Sofa FrontLeszek Sofa SideMartina Office Front 2Martina Office FrontMartina Office Side 2Martina Office SideMartina Sofa Front 2Martina Sofa FrontMartina Sofa Side 2Martina Sofa SideMasha Office Front 2Masha Office FrontMasha Office Side 2Masha Office SideMasha Sofa Casual Front 2Masha Sofa Casual FrontMasha Sofa Casual Side 2Masha Sofa Casual SideMatteo Office Front 2Matteo Office FrontMatteo Office Side 2Matteo Office SideMatteo Sofa Front 2Matteo Sofa FrontMatteo Sofa Side 2Matteo Sofa SideMax Indoor FrontMax Indoor SideMax Outdoor Sport FrontMax Outdoor Sport SideMilena Office Front 2Milena Office FrontMilena Office Side 2Milena Office SideMilena Sofa Front 2Milena Sofa FrontMilena Sofa Side 2Milena Sofa SideMiles Outdoor FrontMiles Outdoor SideMiles Sofa Front 2Miles Sofa FrontMiles Sofa Side 2Miles Sofa SideMireia Business Indoor FrontMireia Business Indoor SideMireia Outdoor Chair FrontMireia Outdoor FrontMireia Outdoor SideMireia Outdoor Table FrontMireia Outdoor Table SideMiyu Office Front 2Miyu Office FrontMiyu Office Side 2Miyu Office SideMiyu Sofa Business FrontMiyu Sofa Business SideMiyu Sofa Casual Front 2Miyu Sofa Casual FrontMiyu Sofa Casual Side 2 Miyu Sofa Casual SideNoah Lobby Front 2Noah Lobby FrontNoah Lobby Side 2Noah Lobby SideNoah Office Front 2Noah Office FrontNoah Office Side 2Noah Office SideNoah Sofa Front 2Noah Sofa Front Noah Sofa Side 2Noah Sofa SideOxana Gym Front 2Oxana Gym FrontOxana Gym Side 2Oxana Gym SideOxana Office Front 2Oxana Office FrontOxana Office Side 2Oxana Office SideOxana Sofa Front 2Oxana Sofa FrontOxana Sofa Side 2Oxana Sofa SideOxana Yoga Front 2Oxana Yoga FrontOxana Yoga Side 2Oxana Yoga SidePatrizio Business Training FrontPatrizio Business Training SidePatrizio Office FrontPatrizio Office Side 2Patrizio Office SidePatrizio Sofa FrontPatrizio Sofa SidePiper Business Sofa FrontPiper Business Sofa SidePiper Education FrontPiper Education SideRasmus Lounge Front 2Rasmus Lounge FrontRasmus Lounge Side 2Rasmus Lounge SideRasmus Sofa Front 2Rasmus Sofa FrontRasmus Sofa Side 2Rasmus Sofa SideRaul Business Sofa Front 2Raul Business Sofa FrontRaul Business Sofa Side 2Raul Business Sofa SideRaul Casual Sofa Front 2Raul Casual Sofa FrontRaul Casual Sofa Side 2Raul Casual Sofa SideRaul Casual Sofa no iPad FrontRaul Casual Sofa no iPad SideRaul Casual Sofa with iPad FrontRaul Casual Sofa with iPad SideRaul Office Front 2Raul Office FrontRaul Office SideRaul Sofa Front 2Raul Sofa FrontRaul Sofa Side 2Raul Sofa SideRen Office Front 2Ren Office FrontRen Office Side 2Ren Office SideRen Sofa Business FrontRen Sofa Business SideRen Sofa Casual Front 2Ren Sofa Casual FrontRen Sofa Casual Side 2 Ren Sofa Casual SideRiley Casual FrontRiley Casual SideRiley Office FrontRiley Office SideRoman Outdoor Sport FrontRoman Outdoor Sport SideSabine Office Front 2Sabine Office FrontSabine Office SideSabine Sofa SideSanta Fireplace FrontSanta Fireplace SideScarlett Couch Front 2Scarlett Couch FrontScarlett Couch Side 2Scarlett Couch SideScarlett Fireplace FrontScarlett Fireplace SideScarlett Hall FrontScarlett Hall SideScarlett Yoga FrontScarlett Yoga SideShawn TherapistSilas Customer SupportSilas HRSilas Lounge FrontSilas Lounge SideSilas Sofa Side 2Silas Sofa SideTeodor Office Front 2Teodor Office FrontTeodor Office Side 2Teodor Office SideTeodor Sofa Front 2Teodor Sofa FrontTeodor Sofa Side 2Teodor Sofa SideTimothy Casual FrontTimothy Casual SideTimothy Office FrontTimothy Office SideVeit Office FrontVeit Office SideVeit Sofa FrontVeit Sofa SideVernon Office Front 2Vernon Office FrontVernon Office Side 2Vernon Office SideVerena Office FrontVerena Office SideVerena Sofa FrontVerena Sofa SideVernon Lounge Front 2Vernon Lounge Side 2Vernon Lounge SideVince Business Sofa FrontVince Business Training FrontVince Business Training Side 2Vince Business Training SideVince Sofa Casual Front 2Vince Sofa Casual FrontVince Sofa Casual Side 2Vince Sofa Casual SidepromptstringНеобязательноminLength 1maxLength 5000Текст, который будет озвучивать аватар, строковый тип; обязателен, если не передан audio_url.
captionbooleanНеобязательноПо умолчанию: falseУказывать ли дополнительно файл субтитров SRT, логический тип, по умолчанию false.
audio_urlstringНеобязательноpattern ^https://HTTPS-адрес аудио для синхронизации губ, строковый тип, длительность аудио до 600 секунд; при передаче этого параметра prompt и voice игнорируются.
backgroundobjectНеобязательно
Группа настроек фона, управляет параметрами фона выходного видео, содержит два подполя: тип и значение.
typestringОбязательноУказывает тип фона, строковый тип, конкретные значения определяются настройкой группы background.
colorimagevaluestringОбязательноminLength 1Указывает значение фона, строковый тип, используется вместе с background.type.
resolutionstringНеобязательноПо умолчанию: "720p"Управляет разрешением выходного видео, строковый тип, по умолчанию 720p.
720p1080p4kaspect_ratiostringНеобязательноПо умолчанию: "16:9"Управляет соотношением сторон кадра выходного видео, строковый тип, по умолчанию 16:9.
16:99:164:55:41:1autooutput_formatstringНеобязательноПо умолчанию: "mp4"Управляет форматом выходного файла, строковый тип, по умолчанию mp4.
mp4webmremove_backgroundbooleanНеобязательноПо умолчанию: falseУдалять ли фон изображения, логический тип, по умолчанию false.
callbackobjectНеобязательно
Настройка уведомления о терминальном состоянии. Если не задана — обратных вызовов нет, опрашивайте задачу сами.
Укажите callback.url при создании, и HiAPI отправит POST вашему сервису в терминальном состоянии — опрос не нужен. Тело callback повторяет структуру деталей задачи; проверка подписи, повторы и идемпотентность описаны во введении единого асинхронного API.
urlstringОбязательноОбязательна при наличии callback. В терминальном состоянии на этот URL отправляется POST; это должна быть корректная http(s)-ссылка.
whenstringНеобязательноПо умолчанию: "final"Сейчас поддерживается только final — уведомление и при success, и при fail.
finalstoragestringНеобязательноПо умолчанию: "temp"Уровень хранения артефактов: temp (по умолчанию, ~7 дней) или persistent (долгосрочно, оплата по объёму). При нехватке баланса или превышении лимита — тихое понижение до temp; фактический уровень виден в ответе деталей задачи.
temppersistentПримеры запроса
# Отправляет асинхронную задачу; сразу возвращает taskId (не ждёт генерации)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "heygen-avatar-v",
"input": {
"fit": "cover",
"voice": "Warm Pro Narrator",
"avatar": "Abigail Sofa Front",
"caption": false,
"resolution": "720p",
"aspect_ratio": "16:9",
"output_format": "mp4",
"remove_background": false
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "heygen-avatar-v",
input: {
"fit": "cover",
"voice": "Warm Pro Narrator",
"avatar": "Abigail Sofa Front",
"caption": false,
"resolution": "720p",
"aspect_ratio": "16:9",
"output_format": "mp4",
"remove_background": false
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "heygen-avatar-v",
"input": {
"fit": "cover",
"voice": "Warm Pro Narrator",
"avatar": "Abigail Sofa Front",
"caption": False,
"resolution": "720p",
"aspect_ratio": "16:9",
"output_format": "mp4",
"remove_background": False
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Получить детали задачи
https://api.hiapi.ai/v1/tasks/:id Поля ответа
taskIdstringОбязательноИдентификатор задачи, всегда с префиксом tk-hiapi-.
modelstringОбязательноПолное разрешённое имя модели. Задачи, отправленные с параметром route, возвращают base@route (напр. gpt-image-2/text-to-image@ext); иначе совпадает с переданным именем.
routestringНеобязательноПрисутствует только при явном параметре route; повторяет переданное значение.
statusstringОбязательноСтатус задачи.
queued В очереди, ещё не начата.
handling Обрабатывается.
archiving Обработка завершена, готовятся артефакты.
success Терминальное: завершено, артефакты доступны (возвращается output).
fail Терминальное: ошибка (возвращается error).
После отправки следите за status: success и fail — терминальные, остальные нет. Опрашивайте каждые 1–3 с до терминального состояния. При успехе скачайте артефакты из output[].url и перенесите до expireAt; для длительного хранения укажите storage: "persistent" при создании.
creatednumberОбязательноВремя создания задачи (Unix-секунды).
completednumberОбязательноUnix-секунды терминального состояния; до этого — 0.
outputarrayНеобязательно
Только при status == success. Список артефактов — всегда массив; одна задача может вернуть несколько type сразу (напр. video + first_frame).
Array [ object ]
Элементы массива
urlstringОбязательноURL артефакта, доступен для скачивания напрямую.
typestringОбязательноТекущие возможные значения: video, image, audio, first_frame, last_frame, thumbnail; список может расширяться.
expireAtnumberОбязательноUnix-секунды доступности артефакта; скачайте или перенесите до истечения.
errorobjectНеобязательно
Только при status == fail.
codestringОбязательноБизнес-код ошибки.
messagestringОбязательноОписание ошибки.
Примеры ответа
Успех
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} Обработка (не финальное)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Ошибка
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Статьи
Все статьи →-
Руководство
kandinsky-6.0-pro/image-to-video в HiAPI: руководство по curl + Python
Как выполнить рабочий запрос генерации видео из изображения в HiAPI: от загрузки первого кадра до асинхронного опроса и финальной загрузки
-
Руководство
Как вызывать kling-4.0/image-to-video на HiAPI: curl, Python и опрос
-
Руководство
Как вызвать hailuo-2.3-fast/image-to-video через HiAPI API: практика с curl и Python
Первый рабочий запрос к быстрому и недорогому уровню генерации видео по изображению — от ID модели до загрузки MP4
-
Руководство
Как использовать kling-4.0/text-to-video через HiAPI API: curl, Python и рабочий пример запроса
Практическое руководство для разработчиков: кинематографичные промпты, синхронный звук, асинхронный опрос и скачивание результатов
-
Руководство
Как вызывать hailuo-2.3/text-to-video через API HiAPI: curl, Python и рабочие примеры запросов
-
Руководство
Использование Kandinsky 6.0 Pro для преобразования текста в видео на HiAPI: руководство по curl и Python
Практическая демонстрация с упором на запросы: построение вызова от промпта до видеоклипа, отправка запроса, опрос статуса завершения и скачивание результата
Похожие модели
Все модели →Тот же тип
-
Hailuo 2.3 MiniMax $0.270 /видео -
HappyHorse 1.0 Alibaba $0.168 /секунду -
Kling 3.0 Turbo Kuaishou $0.130 /секунду -
Kling 2.5 Kuaishou $0.060 /секунду -
Runway Gen 4.5 Runway $0.172 /секунду -
Seedance 2.0 ByteDance $0.017 /секунду -
Gemini Omni Google -- -
Ray 3.2 Luma $0.214 /видео -
Wan 2.6 Flash Alibaba $0.043 /секунду -
MiniMax H3 MiniMax $0.072 /секунду -
Veo 3.1 Fast Google $0.170 /секунду -
Kandinsky 6.0 Pro $1.93 /видео