שפּרינגען צו אינהאַלט

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־קרעדיטן · ≈ ⁨₽ 107.58⁩ אײַערע פֿײַלן ווערן געמאסטן איידערן לויפֿן לויפֿן עס אויף דער דאָזיקער בלאַט

באַקומען אַן API שליסל
HeyGen ליפּסינק און אַוואַטאַרן 4K רעזולטאַטליפּסינקביז 4k #avatar#digital-twin#talking-avatar#text-to-video

אַוואַטאַר V דיגיטאַלער צווילינג מיט 4k רעזולטאַט, דורכזיכטיקן WebM, הינטערגרונט, וואַסערמאַרק און SRT אונטערשריפֿטן

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"

לויפֿן דעם ריקוועסט

אײַער 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
+86 נאָךAndrewSpuds 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`, אָדער אַן HTTP(S) URL ווען דער טיפּ איז `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"
  }
}
אייער טעקעס, אייער ברירהיעדער outputs[].url איז אַ קאַפּיע אין אונדזער סטאָרידזש: געהאַלטן אויף אייביק (באַצאָלט פּער GB־חודש) אָדער 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} | nullSRT־אונטערשריפֿט־פֿײַל געשאַפֿן ווען `caption=True`, אויב דער דינסט צושטעלט איינעם.

פֿאַר AI־אַגענטן: דער בלאַט ווי Markdown געפֿינט זיך בײַ https://doitong.com/yi/developers/models/heygen/avatar5/digital-twin.md. אַלע מאָדעלן און גוידעס: https://doitong.com/developers/llms.txt