Мазмұнға өту

Heygen v5 Digital Twin

Интеграциялау

Модель идентификаторы 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 кредиті · ≈ 107,58 ₽ файлдарыңыз іске қосу алдында өлшенеді Осы бетте іске қосу

API кілтін алу
HeyGen Ерін синхрондауы және аватарлар 4K шығысыЕрін синхрондауы4k дейін #avatar#digital-twin#talking-avatar#text-to-video

4k шығысы, мөлдір WebM, фон, сутаңба және SRT сипаттамалары бар аватар V цифрлық егізі

HeyGen · Бейне

Алғашқы нәтижеңіз осында пайда болады

Төменде сұрау құрып, оны API кілтіңізбен іске қосыңыз. Шығыстар сақтау орнымызға көшіріліп, мәңгі немесе 7 күн тегін сақталады.

Сұрау жасау

Басқару элементтері модель схемасынан жасалады. Оларды өзгерткен сайын код пен баға жаңартылады.

Аватарға арналған сөйлеу мәтіні; `audio_url` көрсетілмесе, міндетті.

audio_url
Файлды тастаңыз немесе

HTTP(S) аудио файл URL ретінде берілетін ерін синхрондау көзі. Бар болса, мәтінді сөйлеуге түрлендіруді алмастырады. Бұл жағдайда `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-ге жіберіледі және Remember параметрін белгілеcеңіз ғана localStorage ішінде сақталады. API кілтін алу

Heygen v5 Digital Twin туралы

Мәтіннен (`prompt` және `voice`) немесе ерін қимылын сәйкестендіруге арналған `audio_url` арқылы сөйлейтін аватар бейнесін жасайды. Атауы бар `avatar`, contain немесе cover мәндері бар `fit` режимін және 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
HTTP(S) аудио файл URL ретінде берілетін ерін синхрондау көзі. Бар болса, мәтінді сөйлеуге түрлендіруді алмастырады. Бұл жағдайда `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` болса, он алтылық түс; түрі `image` болса, HTTP(S) URL.
watermarkміндетті емес
Түріobject
Генерацияланған бейнеге сутаңба ретінде қабатталатын қосымша кескін.
watermark.image_urlміндетті
Түріurl · image
Бейнеге қабаттау үшін HTTP(S) арқылы берілетін сутаңба кескінінің URL мекенжайы.
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 мекенжайын, 10 MB-қа дейінгі data: URI мекенжайын немесе жүктеп салынған файлдың 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"
  }
}
Файлдарыңыз — таңдауыңызӘр outputs[].url — сақтау орнымыздағы көшірме: мәңгі (әр GB-ай үшін ақылы) немесе аккаунт параметрі не ?storage= арқылы 7 күн тегін сақталады.
Әр модельдегі пішім бірдей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`caption=True` болғанда, сервис ұсынса жасалатын SRT субтитр файлы.

AI агенттеріне: бұл беттің Markdown нұсқасы мына жерде: https://doitong.com/kk/developers/models/heygen/avatar5/digital-twin.md. Барлық модельдер мен нұсқаулықтар: https://doitong.com/developers/llms.txt