Op den Inhalt sprangen

Heygen · Avatar4 · Image to Video

Integréieren

Modell-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.com/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Dateie wéi am Beispill: 1,00 $ 1.000 API-Kreditter Är Dateie gi virun der Ausféierung gemooss Op dëser Säit ausféieren

API-Schlëssel kréien
HeyGen Lipsync & Avataren Lipsyncbis zu 1080p #image-to-video

Animéiert eng eenzel Gesiichtsfoto zu engem schwätzenden Avatar, mat stabilem oder expressivem Schwätzstil

HeyGen · Video

Äin éischt Resultat kënnt hei hin

Baut hei drënner eng Ufro a féiert se mat Ärem API-Schlëssel aus. Output gëtt an eis Späicherung kopéiert, fir ëmmer oder 7 Deeg gratis gespäichert.

Eng Ufro erstellen

D'Kontrolle ginn aus dem Modellschema generéiert. De Code an de Präis aktualiséiere sech, wann s du se ännerst.

Text, dee vum Avatar geschwat soll ginn.

•obligatoresch image_url
Fichier erofzéien, oder

Animatiounsquell als Bild-URL; wielt e Bild mat engem kloer siichtbare Gesiicht.

audio_url
Fichier erofzéien, oder

Lëppesynchroniséierungs-Audio iwwer eng Datei-URL, dee bei senger Präsenz souwuel Prompt wéi Stëmm prioritär ersetzt.

resolution Standard 720p

Opléisungs-Preset fir de Video: 360p, 480p, 540p, 720p oder 1080p.

aspect_ratio Standard 16:9

Auswiel vum Video-Aspektverhältnis: 'auto' léisst HeyGen d'Quellverhältnis liesen a behalen, a benotzt '16:9', wann dat net méiglech ass. Explizit Verhältnisser sinn '16:9', '9:16', '4:5', '5:4' an '1:1'.

Erweidert talking_style · voice · expression · caption · enable_safety_checker · background
talking_style Standard stable

Stil vun der Sproochanimatioun: 'stable' hält d'Beweegung minimal, während 'expressive' méi Animatioun bäifüügt.

Numm vun der Stëmm, fir d'Avatar-Stëmm auszewielen.

Ausdrock am Gesiicht.

Astellunge fir den Hannergrond.

POST /run/heygen/avatar4/image-to-video?wait=20 Präis → 1,00 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Dës Ufro ausféieren

Äre Schlëssel bleift an dësem Browser: e gëtt nëmmen un d'Doitong API geschéckt an nëmme gespäichert (localStorage), wann s du „Erënneren“ aktivéiers. En API-Schlëssel kréien

Iwwer Heygen · Avatar4 · Image to Video

Wandelt een eenzegt Bild mat engem kloer erkennbare Gesiicht an e schwätzenden Avatarvideo ëm. Gitt e `prompt` mat dem ze schwätzenden Text an e `voice`-Numm un oder liwwert `audio_url`, wat béides iwwerschreift. `talking_style` wiesselt tëscht stable (minimal Beweegung) an expressive. Dir kënnt och en Ausdrock, en Hannergrond, optional Ënnertitelen an eng Opléisung vun 360p bis 1080p setzen.

Parameteren

Schéck entweder den kanoneschen Numm oder den natierlechen Numm, net béid. Kanonesch Nimm

NummTyp StandardErlaabt Beschreiwung
image_urlobligatoresch image
Typurl · image
Animatiounsquell als Bild-URL; wielt e Bild mat engem kloer siichtbare Gesiicht.
promptoptional
Typstring | null
Text, dee vum Avatar geschwat soll ginn.
voiceoptional
Typenum
Warm Pro NarratorChill BrianIvyJohn DoeMonika SogamHope Archer BrittneyPatrickDavid CastlemoreMichael CAdam Stone JuniperCassidy Jessica Anne BogartArabella
+86 méiAndrewSpuds 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
Numm vun der Stëmm, fir d'Avatar-Stëmm auszewielen.
audio_urloptional audio
Typurl · audio
Lëppesynchroniséierungs-Audio iwwer eng Datei-URL, dee bei senger Präsenz souwuel Prompt wéi Stëmm prioritär ersetzt.
talking_styleoptional
Typenum
Standardstable
stableexpressive
Stil vun der Sproochanimatioun: 'stable' hält d'Beweegung minimal, während 'expressive' méi Animatioun bäifüügt.
expressionoptional
Typstring | null
Ausdrock am Gesiicht.
backgroundoptional
Typobject
Astellunge fir den Hannergrond.
background.typeoptional
Typenum
Standardcolor
colorimagevideo
Auswiel vum Hannergrondtyp.
background.valueoptional
Typstring
Standard#FFFFFF
Hannergrondinhalt: eng hexadezimal Faarf, wann den Typ 'color' ass, oder eng URL, wann den Typ 'image' oder 'video' ass.
resolutionoptional
Typenum
Standard720p
360p480p540p720p1080p
Opléisungs-Preset fir de Video: 360p, 480p, 540p, 720p oder 1080p.
aspect_ratiooptional
Typenum
Standard16:9
16:99:164:55:41:1auto
Auswiel vum Video-Aspektverhältnis: 'auto' léisst HeyGen d'Quellverhältnis liesen a behalen, a benotzt '16:9', wann dat net méiglech ass. Explizit Verhältnisser sinn '16:9', '9:16', '4:5', '5:4' an '1:1'.
captionoptional
Typboolean
Standardfalse
Steiert, ob de Video Ënnertitele enthält.
enable_safety_checkeroptional
Typboolean
Standardtrue
D'Kontroll kann duerch false gelackert ginn, wann den Uruffer autoriséiert ass.
obligatoresch Kanoneschen Numm, och akzeptéiert

Fichierparameter akzeptéieren eng ëffentlech https:// URL, eng data: URI bis zu 10 MB oder de file_url vun engem Upload. Fichieren

Output

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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Är Fichieren, Är WielAll outputs[].url ass eng Kopie an eiser Späicherung: fir ëmmer gespäichert (bezuelbar pro GB-Mount) oder 7 Deeg gratis, jee no Ärer Kontastellung oder ?storage=.
D'selwecht Struktur bei all Modelltype, url, content_type, width, height an duration, fir Biller, Video an Audio gläichermoossen. output ass dem Modell säin eegent Resultatobjet.
Output-Felder
video
object {url, content_type, file_name, file_size}Resultéierend Video-Datei.

Méi Modeller: Lipsync & Avataren

Fir AI-Agenten: dës Säit als Markdown ass ënner https://doitong.com/lb/developers/models/heygen/avatar4/image-to-video.md. All Modeller a Guiden: https://doitong.com/developers/llms.txt