Saltar al cuntegna

Heygen · Avatar4 · Image to Video

Integrar

ID dal model 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"

Datotecas sco l'exempel: $1,00 1 000 credits API · ≈ ₽107,58 tias datotecas vegnan mesiradas avant l'execuziun Lantschar sin questa pagina

Obtegna ina clav API
HeyGen Lipsync e avatars Lipsyncfin a 1080p #image-to-video

Animescha ina fotografia singula da fatscha en in avatar parlant, cun stils da discurrer stabils u expressivs

HeyGen · Video

Tes emprim resultat vegn qua

Construis ina dumonda sutvart e l'exequescha cun tia clav API. Outputs vegnan copiads en nossa memorisaziun, conservads per adina u 7 dis gratuitamain.

Construir ina dumonda

Ils controls vegnan generads dal schema dal model. Il code e ​​il pretsch s'actualiseschan durant che ti als midas.

Text che l'avatar duai discurrer.

•obligatori image_url
Trametta in datoteca u

Funtauna d'animaziun furnida sco URL d'in maletg; tscherna in maletg cun ina fatscha bain visibla.

audio_url
Trametta in datoteca u

Audio da sincronisaziun da las levzas furnì via URL da datoteca, che ha prioritad sur il prompt e la vusch mintga giada ch'el è preschent.

resolution standard 720p

Preset da resoluziun per il video: 360p, 480p, 540p, 720p u 1080p.

aspect_ratio standard 16:9

Tscherna da la proporziun d'aspect dal video: 'auto' dumonda HeyGen da leger e mantegnair la proporziun da la funtauna, utilisond '16:9' sch'ella na po betg vegnir legida. Las proporziuns explicitamain tschernidas èn '16:9', '9:16', '4:5', '5:4', e '1:1'.

Avanzà talking_style · voice · expression · caption · enable_safety_checker · background
talking_style standard stable

Stil da l'animaziun da la lingua: 'stable' mantegna il moviment minimal, entant che 'expressive' agiunta dapli animaziun.

Num da la vusch utilisà per tscherner la vusch da l'avatar.

Expressiun mussada sin il fatscha.

Configuraziuns per il fund.

POST /run/heygen/avatar4/image-to-video?wait=20 calculaziun → $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"

Executar questa dumonda

Tia clav resta en quest browser: ella vegn tramessa mo al Doitong API e memorisada (localStorage) mo sch'ella scheccas Tiar a memoria. Obtegnair ina clav API

Davart Heygen · Avatar4 · Image to Video

Transformescha ina imagina cun ina fatscha clera en ina video d'avatar parlant. Dà in `prompt` cun il text da dir ed in num `voice`, u furnescha `audio_url`, che surpiglia omadus. `talking_style` alternescha tranter stable (moviment minimal) ed expressive. Podes era definir in'expressiun, in fund, subtitles opziunals e ina resoluziun da 360p fin a 1080p.

Parameters

Invia u il num canonic u il num nativ, betg omaduas. Nums canonics

NumTip StandardPermess Descripziun
image_urlobligatori image
Tipurl · image
Funtauna d'animaziun furnida sco URL d'in maletg; tscherna in maletg cun ina fatscha bain visibla.
promptopziunal
Tipstring | null
Text che l'avatar duai discurrer.
voiceopziunal
Tipenum
Warm Pro NarratorChill BrianIvyJohn DoeMonika SogamHope Archer BrittneyPatrickDavid CastlemoreMichael CAdam Stone JuniperCassidy Jessica Anne BogartArabella
+86 dapliAndrewSpuds 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
Num da la vusch utilisà per tscherner la vusch da l'avatar.
audio_urlopziunal audio
Tipurl · audio
Audio da sincronisaziun da las levzas furnì via URL da datoteca, che ha prioritad sur il prompt e la vusch mintga giada ch'el è preschent.
talking_styleopziunal
Tipenum
Standardstable
stableexpressive
Stil da l'animaziun da la lingua: 'stable' mantegna il moviment minimal, entant che 'expressive' agiunta dapli animaziun.
expressionopziunal
Tipstring | null
Expressiun mussada sin il fatscha.
backgroundopziunal
Tipobject
Configuraziuns per il fund.
background.typeopziunal
Tipenum
Standardcolor
colorimagevideo
Selecziun dal tip da fund.
background.valueopziunal
Tipstring
Standard#FFFFFF
Cuntansch dal fund: ina colur esadecimala, sche il tip è 'color', u ina URL, sche il tip è 'image' u 'video'.
resolutionopziunal
Tipenum
Standard720p
360p480p540p720p1080p
Preset da resoluziun per il video: 360p, 480p, 540p, 720p u 1080p.
aspect_ratioopziunal
Tipenum
Standard16:9
16:99:164:55:41:1auto
Tscherna da la proporziun d'aspect dal video: 'auto' dumonda HeyGen da leger e mantegnair la proporziun da la funtauna, utilisond '16:9' sch'ella na po betg vegnir legida. Las proporziuns explicitamain tschernidas èn '16:9', '9:16', '4:5', '5:4', e '1:1'.
captionopziunal
Tipboolean
Standardfalse
Definescha sche il video cuntegna suttitels.
enable_safety_checkeropziunal
Tipboolean
Standardtrue
La controlla po vegnir schluccada cun definir false, premess che l'appelant saja autorisà.
obligatori Num canonic, er acceptà

Ils parameters da datotecas acceptan ina URL publica https://, ina URI data: fin a 10 MB u il file_url d'ina chargiada. Datotecas

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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Tias datotecas, tia decisiunMintga outputs[].url è ina copia en nossa memorisaziun: conservada per adina (pajà per GB-mes) u 7 dis gratuitamain, tenor la configuraziun dal conto u ?storage=.
La medema structura per mintga modeltype, url, content_type, width, height e duration, tant per maletgs sco per video e audio. output è l'object da resultat dal model sez.
Champs da l'output
video
object {url, content_type, file_name, file_size}Datoteca video resultanta.

Dapli models: Lipsync e avatars

Per agents AI: questa pagina sco Markdown è disponibla sut https://doitong.com/rm/developers/models/heygen/avatar4/image-to-video.md. Tut ils models e las guidas: https://doitong.com/developers/llms.txt