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

Heygen · Avatar4 · Image to Video

אינטעגרירן

מאָדעל־id heygen/avatar4/image-to-video
# 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/avatar4/image-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/avatar/talking_avatar.jpg",
    "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 ליפּסינק און אַוואַטאַרן ליפּסינקביז 1080p #image-to-video

אַנימירט איין פּנים־פֿאָטאָ אין אַ רעדנדיקן אַוואַטאַר, מיט סטאַבילן אָדער אויסדרוקפֿולן רעד־סטיל

HeyGen · ווידעא

דאָ קומט אײַער ערשטער רעזולטאַט

בויט אונטן אַ בקשה און לויפט זי מיט אײַער API שליסל. רעזולטאַטן ווערן קאַפּירט צו אונדזער סטאָרידזש, געהאַלטן אויף אייביק אָדער 7 טעג אומזיסט.

בויען אַ בעטן

קאָנטראָלן ווערן דזשענערירט פֿון דעם מאָדעל־סכעמע. דער קאָד און דער פּרײַז דערהײַנטיקן זיך ווען איר ענדערט זיי.

טעקסט וואָס דער אַוואַטאַר זאָל רעדן.

•פארלאנגט image_url
לייגט אַרײַן אַ טעקע, אָדער

אַנימאַציע־מקור צוגעשטעלט ווי אַ בילד־URL; קלייבט אַ בילד מיט אַ קלאָרן זעעוודיקן פּנים.

audio_url
לייגט אַרײַן אַ טעקע, אָדער

ליפּ־סינק־אַודיאָ צוגעשטעלט דורך פֿײַל־URL, וואָס האָט בילכערקייַט איבער סײַ פּראָמפּט סײַ שטימע ווען פאָרהאַנטן.

resolution סטאַנדאַרט 720p

רעזאָלוציע־פּרעסטעט פֿאַרן ווידעא: 360p, 480p, 540p, 720p, אָדער 1080p.

aspect_ratio סטאַנדאַרט 16:9

ווידעא־אַספּעקט־ראַטיאָ־אויסקלײַב: 'auto' בעט HeyGen לייענען און אָפּהיטן דעם מקור־ראַטיאָ, מיט '16:9' אויב עס קען נישט. קלאָרע ראַטיאָ־אויסקלײַבן זענען '16:9', '9:16', '4:5', '5:4', און '1:1'.

פֿאָרגעשריטן talking_style · voice · expression · caption · enable_safety_checker · background
talking_style סטאַנדאַרט stable

סטיל פון רעדנדיקער אַנימאַציע: 'stable' האַלט באַוועגונג מינימאַל, בעת 'expressive' לייגט צו מער אַנימאַציע.

שטימע־נאָמען געניצט צו אויסקלײַבן דעם אַוואַטאַרס שטימע.

אויסדרוק אויפֿן פּנים.

באַשטעטיקונגען פֿאַרן הינטערגרונט.

POST /run/heygen/avatar4/image-to-video?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/avatar4/image-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/avatar/talking_avatar.jpg",
    "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 · Avatar4 · Image to Video

מאַכט פֿון איין בילד מיט אַ קלאָרן פּנים אַ רעדנדיקן אַוואַטאַר־ווידעאָ. געבן אַ `prompt` מיטן טעקסט צו רעדן פּלוס אַ `voice`־נאָמען, אָדער צושטעלן `audio_url`, וואָס איבערשרײַבט ביידע. `talking_style` טוישט צווישן stable (מינימאַלע באַוועגונג) און expressive. מע קען אויך באַשטימען אַן אויסדרוק, אַ הינטערגרונט, אַפּשאַנאַלע אונטערשריפֿטן און רעזאָלוציע פֿון 360p ביז 1080p.

פּאַראַמעטערס

שיקט אָדער דעם קאַנאָנישן נאָמען אָדער דעם נאַטיוון נאָמען, נישט ביידע. קאַנאָנישע נעמען

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
image_urlפארלאנגט image
טיפּurl · image
אַנימאַציע־מקור צוגעשטעלט ווי אַ בילד־URL; קלייבט אַ בילד מיט אַ קלאָרן זעעוודיקן פּנים.
promptאָפּציאָנעל
טיפּstring | null
טעקסט וואָס דער אַוואַטאַר זאָל רעדן.
voiceאָפּציאָנעל
טיפּenum
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, וואָס האָט בילכערקייַט איבער סײַ פּראָמפּט סײַ שטימע ווען פאָרהאַנטן.
talking_styleאָפּציאָנעל
טיפּenum
סטאַנדאַרטstable
stableexpressive
סטיל פון רעדנדיקער אַנימאַציע: 'stable' האַלט באַוועגונג מינימאַל, בעת 'expressive' לייגט צו מער אַנימאַציע.
expressionאָפּציאָנעל
טיפּstring | null
אויסדרוק אויפֿן פּנים.
backgroundאָפּציאָנעל
טיפּobject
באַשטעטיקונגען פֿאַרן הינטערגרונט.
background.typeאָפּציאָנעל
טיפּenum
סטאַנדאַרטcolor
colorimagevideo
אויסקלײַב פֿון הינטערגרונט־טיפּ.
background.valueאָפּציאָנעל
טיפּstring
סטאַנדאַרט#FFFFFF
הינטערגרונט־אינהאַלט: אַ העקסאַדעסימאַלער קאָליר ווען דער טיפּ איז 'color', אָדער אַ URL ווען דער טיפּ איז 'image' אָדער 'video'.
resolutionאָפּציאָנעל
טיפּenum
סטאַנדאַרט720p
360p480p540p720p1080p
רעזאָלוציע־פּרעסטעט פֿאַרן ווידעא: 360p, 480p, 540p, 720p, אָדער 1080p.
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'.
captionאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
קאָנטראָלירט צי דער ווידעא נעמט אַרײַן אונטערשריפֿטן.
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/avatar4/image-to-video",
  "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": {
    "image_url": "https://content.doitong.com/images/showcase/v3/avatar/talking_avatar.jpg",
    "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
    }
  },
  "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}רעזולטירנדיקע ווידעא־פֿײַל.

מער מאָדעלן: ליפּסינק און אַוואַטאַרן

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