Vai al contenuto

Heygen v5 Digital Twin

Integra

ID del modello 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"

File come nell'esempio: 1,00 $ 1000 crediti API i tuoi file vengono misurati prima dell'esecuzione Esegui in questa pagina

Ottieni la chiave API
HeyGen Lipsync e avatar Output 4KLipsyncfino a 4k #avatar#digital-twin#talking-avatar#text-to-video

Digital twin Avatar V con output 4k, WebM trasparente, sfondo, filigrana e didascalie SRT

HeyGen · Video

Il tuo primo risultato apparirà qui

Crea una richiesta qui sotto ed eseguila con la tua chiave API. Gli output vengono copiati nella nostra archiviazione, conservati per sempre oppure 7 giorni gratuitamente.

Crea una richiesta

I controlli vengono generati dallo schema del modello. Il codice e il prezzo si aggiornano mentre li modifichi.

Testo parlato dall'avatar; obbligatorio se `audio_url` è omesso.

audio_url
Trascina un file oppure

Sorgente per la sincronizzazione labiale fornita come URL HTTP(S) di un file audio, che sostituisce la sintesi vocale quando presente. In tal caso non vengono usati né `prompt` né `voice`.

resolution predefinito 720p

Preimpostazione della risoluzione per l'output generato.

aspect_ratio predefinito 16:9

Selezione delle proporzioni del video: 'auto' chiede a HeyGen di leggere e mantenere le proporzioni sorgente, usando '16:9' se non è possibile. Le proporzioni esplicite sono '16:9', '9:16', '4:5', '5:4' e '1:1'.

Avanzate fit · output_format · avatar · voice · remove_background · caption · enable_safety_checker · background · watermark
fit predefinito cover

Scegli l'inquadratura dell'avatar: 'cover' riempie il fotogramma di output ma può ritagliare l'avatar, mentre 'contain' mostra l'intero avatar ma può aggiungere bande nere.

output_format predefinito mp4

Selezione del contenitore video, con `webm` che abilita la trasparenza tramite la rimozione automatica dello sfondo; in tale modalità `background` non ha effetto.

predefinito Abigail Sofa Front

Nome che identifica un avatar idoneo per Avatar V.

predefinito Warm Pro Narrator

Selezione della voce dell'avatar per nome per la sintesi vocale; si applica solo senza un `audio_url`.

Livello di sfondo posizionato facoltativamente dietro l'avatar, tranne con `output_format='webm'`: l'output webm trasparente ignora questa impostazione.

Immagine facoltativa usata come filigrana sovrapposta nel video generato.

POST /run/heygen/avatar5/digital-twin?wait=20 preventivo → 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"

Esegui questa richiesta

La tua chiave rimane in questo browser: viene inviata solo al Doitong API e salvata in localStorage solo se selezioni Ricorda. Ottieni una chiave API

Informazioni su Heygen v5 Digital Twin

Crea un video di avatar parlante dal testo (`prompt` e `voice`) o da un `audio_url` per la sincronizzazione labiale. Seleziona un `avatar` nominato, una modalità `fit` tra contain e cover e una risoluzione di 720p, 1080p o 4k. `output_format` può essere mp4 o webm; webm è trasparente. Le opzioni includono composizione dello sfondo, sovrapposizione di una filigrana e un file di didascalie SRT separato.

Parametri

Invia il nome canonico oppure il nome nativo, non entrambi. Nomi canonici

NomeTipo PredefinitoConsentiti Descrizione
avatarfacoltativo
Tipostring | null
PredefinitoAbigail Sofa Front
Nome che identifica un avatar idoneo per Avatar V.
promptfacoltativo
Tipostring | null
Testo parlato dall'avatar; obbligatorio se `audio_url` è omesso.
voicefacoltativo
Tipoenum
PredefinitoWarm Pro Narrator
Warm Pro NarratorChill BrianIvyJohn DoeMonika SogamHope Archer BrittneyPatrickDavid CastlemoreMichael CAdam Stone JuniperCassidy Jessica Anne BogartArabella
+86 altriAndrewSpuds 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
Selezione della voce dell'avatar per nome per la sintesi vocale; si applica solo senza un `audio_url`.
audio_urlfacoltativo audio
Tipourl · audio
Sorgente per la sincronizzazione labiale fornita come URL HTTP(S) di un file audio, che sostituisce la sintesi vocale quando presente. In tal caso non vengono usati né `prompt` né `voice`.
fitfacoltativo
Tipoenum
Predefinitocover
containcover
Scegli l'inquadratura dell'avatar: 'cover' riempie il fotogramma di output ma può ritagliare l'avatar, mentre 'contain' mostra l'intero avatar ma può aggiungere bande nere.
remove_backgroundfacoltativo
Tipoboolean
Predefinitofalse
Rimozione dello sfondo dell'avatar; disponibile solo per gli avatar che supportano il matting.
backgroundfacoltativo
Tipoobject
Livello di sfondo posizionato facoltativamente dietro l'avatar, tranne con `output_format='webm'`: l'output webm trasparente ignora questa impostazione.
background.typefacoltativo
Tipoenum
Predefinitocolor
colorimage
Tipo di sfondo: `color` specifica un colore esadecimale uniforme, mentre `image` specifica un URL di immagine.
background.valuefacoltativo
Tipostring
Predefinito#FFFFFF
Contenuto dello sfondo: un colore esadecimale quando il tipo è `color` oppure un URL HTTP(S) quando il tipo è `image`.
watermarkfacoltativo
Tipoobject
Immagine facoltativa usata come filigrana sovrapposta nel video generato.
watermark.image_urlobbligatorio
Tipourl · image
URL HTTP(S) dell'immagine della filigrana da sovrapporre al video.
watermark.scalefacoltativo
Tiponumber | null
≤ 2, > 0
Dimensione della filigrana relativa al video, maggiore di 0.0 e fino a 2.0.
watermark.opacityfacoltativo
Tiponumber | null
0 – 1
Livello di trasparenza della filigrana: 0.0 è completamente trasparente e 1.0 completamente opaca.
watermark.placementfacoltativo
Tipoenum
top-lefttop-rightbottom-leftbottom-right
Posizione della filigrana nel video.
captionfacoltativo
Tipoboolean
Predefinitofalse
Controlla la generazione di un file di sottotitoli SRT separato associato al video.
output_formatfacoltativo
Tipoenum
Predefinitomp4
mp4webm
Selezione del contenitore video, con `webm` che abilita la trasparenza tramite la rimozione automatica dello sfondo; in tale modalità `background` non ha effetto.
resolutionfacoltativo
Tipoenum
Predefinito720p
720p1080p4k
Preimpostazione della risoluzione per l'output generato.
aspect_ratiofacoltativo
Tipoenum
Predefinito16:9
16:99:164:55:41:1auto
Selezione delle proporzioni del video: 'auto' chiede a HeyGen di leggere e mantenere le proporzioni sorgente, usando '16:9' se non è possibile. Le proporzioni esplicite sono '16:9', '9:16', '4:5', '5:4' e '1:1'.
enable_safety_checkerfacoltativo
Tipoboolean
Predefinitotrue
Il controllo può essere allentato impostando false, se il chiamante è autorizzato.
obbligatorio Nome canonico, accettato anche

I parametri file accettano un URL pubblico https://, un URI data: fino a 10 MB oppure il file_url di un caricamento. File

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"
  }
}
I tuoi file, la tua sceltaOgni outputs[].url è una copia nella nostra archiviazione: conservata per sempre (a pagamento per GB-mese) oppure 7 giorni gratuitamente, in base all'impostazione dell'account o a ?storage=.
Stessa struttura per ogni modellotype, url, content_type, width, height e duration, per immagini, video e audio. output è l'oggetto risultato del modello.
Campi dell'output
video
object {url, content_type, file_name, file_size}File video prodotto da Avatar V.
caption_file
object {url, content_type, file_name, file_size} | nullFile di sottotitoli SRT prodotto quando `caption=True`, se il servizio ne fornisce uno.

Per gli agenti AI: questa pagina in Markdown è disponibile all'indirizzo https://doitong.com/it/developers/models/heygen/avatar5/digital-twin.md. Tutti i modelli e le guide: https://doitong.com/developers/llms.txt