Op den Inhalt sprangen

Heygen v5 Digital Twin

Integréieren

Modell-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.com/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.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 4K-OutputLipsyncbis zu 4k #avatar#digital-twin#talking-avatar#text-to-video

Avatar V Digital Twin mat 4k-Ausgab, transparentem WebM, Hannergrond, Waasserzeechen a SRT-Ënnertitelen

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, deen den Avatar schwätzt; erfuerderlech, wann `audio_url` net uginn ass.

audio_url
Fichier erofzéien, oder

Quell fir d'Lëppesynchronisatioun, als HTTP(S)-URL vun enger Audiodatei; ersetzt Text-zu-Sprooch, wann uginn. An deem Fall ginn weder `prompt` nach `voice` benotzt.

resolution Standard 720p

Opléisungsvirlag fir den generéierten Output.

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 fit · output_format · avatar · voice · remove_background · caption · enable_safety_checker · background · watermark
fit Standard cover

Wielt d'Kad réierung vum Avatar: 'cover' fëllt de Output-Frame, kann den Avatar awer ofschneiden, wärend 'contain' de ganzen Avatar weist, awer Letterboxing derbäisetze kann.

output_format Standard mp4

Auswiel vum Video-Container, woubäi `webm` Transparenz duerch automatesch Hannergrondentfernung erméiglecht; an deem Modus huet `background` keen Effekt.

Standard Abigail Sofa Front

Numm, deen en Avatar identifizéiert, dee fir Avatar V gëeegent ass.

Standard Warm Pro Narrator

Auswiel vun der Avatarstëmm nom Numm fir Text-zu-Sprooch; gëllt nëmmen ouni `audio_url`.

Hannergrond-Layer, déi fakultativ hannert dem Avatar placéiert gëtt, ausser mat `output_format='webm'`: Transparente WebM-Output ignoréiert dës Astellung.

Fakultativt Bild, dat als Waasserzeechen-Overlay am generéierte Video benotzt gëtt.

POST /run/heygen/avatar5/digital-twin?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/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.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 v5 Digital Twin

Erstellt e schwätzenden Avatarvideo aus Text (`prompt` an `voice`) oder aus engem `audio_url` fir d’Lëppsynchronisatioun. Wielt en benannten `avatar`, e `fit`-Modus vun contain oder cover an eng Opléisung vun 720p, 1080p oder 4k. `output_format` kann mp4 oder webm sinn; webm ass transparent. Optioune sinn Hannergrond-Kompositing, eng Waasserzeechen-Iwwerlagung an eng separat SRT-Ënnertiteld Datei.

Parameteren

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

NummTyp StandardErlaabt Beschreiwung
avataroptional
Typstring | null
StandardAbigail Sofa Front
Numm, deen en Avatar identifizéiert, dee fir Avatar V gëeegent ass.
promptoptional
Typstring | null
Text, deen den Avatar schwätzt; erfuerderlech, wann `audio_url` net uginn ass.
voiceoptional
Typenum
StandardWarm Pro Narrator
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
Auswiel vun der Avatarstëmm nom Numm fir Text-zu-Sprooch; gëllt nëmmen ouni `audio_url`.
audio_urloptional audio
Typurl · audio
Quell fir d'Lëppesynchronisatioun, als HTTP(S)-URL vun enger Audiodatei; ersetzt Text-zu-Sprooch, wann uginn. An deem Fall ginn weder `prompt` nach `voice` benotzt.
fitoptional
Typenum
Standardcover
containcover
Wielt d'Kad réierung vum Avatar: 'cover' fëllt de Output-Frame, kann den Avatar awer ofschneiden, wärend 'contain' de ganzen Avatar weist, awer Letterboxing derbäisetze kann.
remove_backgroundoptional
Typboolean
Standardfalse
Hannergrondentfernung fir den Avatar; nëmme fir Avataren verfügbar, déi Matting ënnerstëtzen.
backgroundoptional
Typobject
Hannergrond-Layer, déi fakultativ hannert dem Avatar placéiert gëtt, ausser mat `output_format='webm'`: Transparente WebM-Output ignoréiert dës Astellung.
background.typeoptional
Typenum
Standardcolor
colorimage
Hannergrondtyp: `color` spezifizéiert eng zolidd hexadezimal Faarf, wärend `image` eng Bild-URL spezifizéiert.
background.valueoptional
Typstring
Standard#FFFFFF
Hannergrondinhalt: eng hexadezimal Faarf, wann den Typ `color` ass, oder eng HTTP(S)-URL, wann den Typ `image` ass.
watermarkoptional
Typobject
Fakultativt Bild, dat als Waasserzeechen-Overlay am generéierte Video benotzt gëtt.
watermark.image_urlobligatoresch
Typurl · image
HTTP(S)-URL vum Waasserzeechen-Bild, fir et iwwer de Video ze leeën.
watermark.scaleoptional
Typnumber | null
≤ 2, > 0
Gréisst vum Waasserzeechen am Verhältnis zum Video, méi grouss wéi 0.0 a bis zu 2.0.
watermark.opacityoptional
Typnumber | null
0 – 1
Transparenz vum Waasserzeechen: 0.0 ass komplett transparent an 1.0 komplett onduerchsiichteg.
watermark.placementoptional
Typenum
top-lefttop-rightbottom-leftbottom-right
Positioun vum Waasserzeechen am Video.
captionoptional
Typboolean
Standardfalse
Steiert d'Generatioun vun enger separater SRT-Ënnertiteldatei, déi de Video begleet.
output_formatoptional
Typenum
Standardmp4
mp4webm
Auswiel vum Video-Container, woubäi `webm` Transparenz duerch automatesch Hannergrondentfernung erméiglecht; an deem Modus huet `background` keen Effekt.
resolutionoptional
Typenum
Standard720p
720p1080p4k
Opléisungsvirlag fir den generéierten Output.
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'.
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/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.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}Videodatei, déi vun Avatar V produzéiert gëtt.
caption_file
object {url, content_type, file_name, file_size} | nullSRT-Ënnertiteldatei, déi mat `caption=True` produzéiert gëtt, wann de Service eng liwwert.

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