Перейти к содержимому

Heygen v5 Digital Twin

Интеграция

ID модели heygen/avatar5/digital-twin
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/heygen/avatar5/digital-twin?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "audio": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Файлы, как в примере: 1,00 $ 1 000 API-кредитов · ≈ 106,78 ₽ ваши файлы измеряются перед запуском Запустить на этой странице

Получить API-ключ
HeyGen Синхронизация губ и аватары Вывод в 4KСинхронизация губдо 4k #avatar#digital-twin#talking-avatar#text-to-video

Цифровой двойник аватар V с выходом 4k, прозрачным WebM, фоном, водяным знаком и субтитрами SRT

HeyGen · Видео

Здесь появится ваш первый результат

Составьте запрос ниже и выполните его с помощью API-ключа. Результаты копируются в наше хранилище и хранятся навсегда или 7 дней бесплатно.

Сформировать запрос

Элементы управления сгенерированы из схемы модели. Код и цена обновляются при изменении параметров.

Текст речи для аватара; требуется, если `audio_url` не указан.

audio_url
Перетащите файл или

Источник синхронизации губ в виде URL аудиофайла HTTP(S), заменяющий преобразование текста в речь при наличии. В этом случае ни `prompt`, ни `voice` не используются.

resolution по умолчанию 720p

Предустановка разрешения для сгенерированных выходных данных.

aspect_ratio по умолчанию 16:9

Выбор соотношения сторон видео: 'auto' просит HeyGen определить и сохранить соотношение исходника, используя '16:9', если это невозможно. Явные варианты: '16:9', '9:16', '4:5', '5:4' и '1:1'.

Расширенные fit · output_format · avatar · voice · remove_background · caption · enable_safety_checker · background · watermark
fit по умолчанию cover

Выбор кадрирования аватара: 'cover' заполняет выходной кадр, но может обрезать аватар, а 'contain' показывает аватар целиком, но может добавить поля.

output_format по умолчанию mp4

Выбор контейнера видео; `webm` включает прозрачность посредством автоматического удаления фона. В этом режиме `background` не влияет на результат.

по умолчанию Abigail Sofa Front

Имя аватара, поддерживающего Avatar V.

по умолчанию Warm Pro Narrator

Выбор голоса аватара по имени для преобразования текста в речь; применяется только без `audio_url`.

Слой фона, помещаемый за аватаром; не применяется при `output_format='webm'`: прозрачный вывод webm игнорирует эту настройку.

Необязательное изображение, используемое как водяной знак в сгенерированном видео.

POST /run/heygen/avatar5/digital-twin?wait=20 стоимость → 1,00 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/heygen/avatar5/digital-twin?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "audio": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Запустить этот запрос

Ваш ключ хранится в этом браузере: он отправляется только в Doitong API и сохраняется в localStorage только при включении параметра «Запомнить». Получить API-ключ

О Heygen v5 Digital Twin

Создаёт видео говорящего аватара из текста (`prompt` и `voice`) или `audio_url` для синхронизации губ. Выберите именованный `avatar`, режим `fit` со значением contain или cover и разрешение 720p, 1080p или 4k. `output_format` может быть mp4 или webm; webm поддерживает прозрачность. Доступны композитинг фона, наложение водяного знака и отдельный файл субтитров SRT.

Параметры

Передавайте либо каноническое имя, либо исходное имя, но не оба. Канонические имена

ИмяТип По умолчаниюДопустимые значения Описание
avatarнеобязательно
Типstring | null
По умолчаниюAbigail Sofa Front
Имя аватара, поддерживающего Avatar V.
promptнеобязательно
Типstring | null
Текст речи для аватара; требуется, если `audio_url` не указан.
voiceнеобязательно
Типenum
По умолчаниюWarm Pro Narrator
Warm Pro NarratorChill BrianIvyJohn DoeMonika SogamHope Archer BrittneyPatrickDavid CastlemoreMichael CAdam Stone JuniperCassidy Jessica Anne BogartArabella
ещё 86AndrewSpuds Oxley Grace ElderHelenCanyon RiversDerya - Lifelike - Excited 🤩Mellow MarcusJack Sterling - Broadcaster 🎙️Brenda - UGC - 1.mp4ReidReaganTerryJennyRadio RickDeniseTim in car - Excited 🤩IskanderThompsonDelicate Daisy - Excited 🤩KingstonGeorge UGC 1Bold BlakeJaneExpressive EvanMarianne - IAAaronModern Recipe Host - Voice 1WillowCute Chloe - Friendly 😊RafaelJune - LifelikeCrisp ChloeSlick SimonNassim - InformativeBaritone BenMaxwellEllie Faye - Excited 🤩MilaniFeisty Fiona - Excited 🤩Professor DeanRose - UGC - 1.mp4ShonaHudson WilderAnn - IAAlastair KensingtonOxleyChristinaAndrew Rizz PeytonGerardo - OutdoorChloe - LifelikeStephanieAnthony - IASignal - Voice 1LucaLisa - Voice 1T.W.TuckerJack Sullivan - Serious 😐WinterMireia - LifelikeGeorgiaStellaMasha - LifelikeCharming Charles - Friendly 😊SerenityAnnie - ExcitedRalphBethanyDominicMason FinnLeenaVeteran VictorTamaraNik PublicCalm ChloeSevikReillyRaulImposing IanRelaxed RayDexter - ProfessionalRelaxed RickEdwinRupert BlackwoodGinnyHope
Выбор голоса аватара по имени для преобразования текста в речь; применяется только без `audio_url`.
audio_urlнеобязательно audio
Типurl · audio
Источник синхронизации губ в виде URL аудиофайла HTTP(S), заменяющий преобразование текста в речь при наличии. В этом случае ни `prompt`, ни `voice` не используются.
fitнеобязательно
Типenum
По умолчаниюcover
containcover
Выбор кадрирования аватара: 'cover' заполняет выходной кадр, но может обрезать аватар, а 'contain' показывает аватар целиком, но может добавить поля.
remove_backgroundнеобязательно
Типboolean
По умолчаниюfalse
Удаление фона аватара; доступно только для аватаров с поддержкой маттинга.
backgroundнеобязательно
Типobject
Слой фона, помещаемый за аватаром; не применяется при `output_format='webm'`: прозрачный вывод webm игнорирует эту настройку.
background.typeнеобязательно
Типenum
По умолчаниюcolor
colorimage
Тип фона: `color` задаёт сплошной шестнадцатеричный цвет, а `image` — URL изображения.
background.valueнеобязательно
Типstring
По умолчанию#FFFFFF
Содержимое фона: шестнадцатеричный цвет для типа `color` или URL HTTP(S) для типа `image`.
watermarkнеобязательно
Типobject
Необязательное изображение, используемое как водяной знак в сгенерированном видео.
watermark.image_urlобязательно
Типurl · image
URL изображения водяного знака HTTP(S) для наложения на видео.
watermark.scaleнеобязательно
Типnumber | null
≤ 2, > 0
Размер водяного знака относительно видео: больше 0.0 и не больше 2.0.
watermark.opacityнеобязательно
Типnumber | null
0 – 1
Прозрачность водяного знака: 0.0 — полностью прозрачный, 1.0 — полностью непрозрачный.
watermark.placementнеобязательно
Типenum
top-lefttop-rightbottom-leftbottom-right
Положение водяного знака в видео.
captionнеобязательно
Типboolean
По умолчаниюfalse
Определяет генерацию отдельного файла субтитров SRT вместе с видео.
output_formatнеобязательно
Типenum
По умолчаниюmp4
mp4webm
Выбор контейнера видео; `webm` включает прозрачность посредством автоматического удаления фона. В этом режиме `background` не влияет на результат.
resolutionнеобязательно
Типenum
По умолчанию720p
720p1080p4k
Предустановка разрешения для сгенерированных выходных данных.
aspect_ratioнеобязательно
Типenum
По умолчанию16:9
16:99:164:55:41:1auto
Выбор соотношения сторон видео: 'auto' просит HeyGen определить и сохранить соотношение исходника, используя '16:9', если это невозможно. Явные варианты: '16:9', '9:16', '4:5', '5:4' и '1:1'.
enable_safety_checkerнеобязательно
Типboolean
По умолчаниюtrue
Проверку можно ослабить, установив false, если вызывающая сторона авторизована.
обязательно Каноническое имя, также принимается

Параметры файлов принимают общедоступный https:// URL, data: URI размером до 10 MB или file_url загруженного файла. Файлы

Результат

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "heygen/avatar5/digital-twin",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 1000,
    "usd": "1.00",
    "charged": 1000,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "audio_url": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    },
    "caption_file": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    }
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Ваши файлы — ваш выборКаждый URL из outputs[].url — это копия в нашем хранилище: она хранится навсегда (оплата за ГБ в месяц) или 7 дней бесплатно — в зависимости от настройки вашего аккаунта или параметра ?storage=.
Одинаковая структура у каждой моделиtype, url, content_type, width, height и duration — одинаково для изображений, видео и аудио. output — собственный объект результата модели.
Поля результата
video
object {url, content_type, file_name, file_size}Видео-файл, созданный Avatar V.
caption_file
object {url, content_type, file_name, file_size} | nullФайл субтитров SRT, созданный при `caption=True`, если сервис его предоставляет.

Для AI-агентов: эта страница в формате Markdown доступна по адресу https://doitong.com/developers/models/heygen/avatar5/digital-twin.md. Все модели и руководства: https://doitong.com/developers/llms.txt