Passer au contenu

Heygen v5 Digital Twin

Intégrer

Identifiant du modèle 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"

Fichiers comme dans l’exemple: 1,00 $ 1 000 crédits API vos fichiers sont mesurés avant l’exécution L’exécuter sur cette page

Obtenir une clé API
HeyGen Synchronisation labiale et avatars Sortie 4KSynchronisation labialejusqu’à 4k #avatar#digital-twin#talking-avatar#text-to-video

Jumeau numérique Avatar V avec sortie 4k, WebM transparent, arrière-plan, filigrane et sous-titres SRT

HeyGen · Vidéo

Votre premier résultat apparaîtra ici

Construisez une requête ci-dessous et exécutez-la avec votre clé API. Les sorties sont copiées dans notre stockage, conservées indéfiniment ou 7 jours gratuitement.

Créer une requête

Les contrôles sont générés à partir du schéma du modèle. Le code et le prix se mettent à jour lorsque vous les modifiez.

Texte parlé par l'avatar ; requis si `audio_url` est omis.

audio_url
Déposez un fichier, ou

Source de synchronisation labiale fournie sous forme d'URL de fichier audio HTTP(S), remplaçant la synthèse vocale lorsqu'elle est présente. Ni `prompt` ni `voice` ne sont utilisés dans ce cas.

resolution par défaut 720p

Préréglage de résolution pour la sortie générée.

aspect_ratio par défaut 16:9

Sélection du format d'image vidéo : 'auto' demande à HeyGen de lire et de conserver le format source, en utilisant '16:9' s'il n'y parvient pas. Les choix explicites sont '16:9', '9:16', '4:5', '5:4' et '1:1'.

Avancé fit · output_format · avatar · voice · remove_background · caption · enable_safety_checker · background · watermark
fit par défaut cover

Choisissez le cadrage de l'avatar : 'cover' remplit l'image de sortie mais peut rogner l'avatar, tandis que 'contain' affiche l'avatar entier mais peut ajouter des bandes noires.

output_format par défaut mp4

Sélection du conteneur vidéo ; `webm` active la transparence grâce à la suppression automatique de l'arrière-plan ; dans ce mode, `background` n'a aucun effet.

par défaut Abigail Sofa Front

Nom identifiant un avatar compatible avec Avatar V.

par défaut Warm Pro Narrator

Sélection de la voix de l'avatar par nom pour la synthèse vocale ; s'applique uniquement sans `audio_url`.

Calque d'arrière-plan placé facultativement derrière l'avatar, sauf avec `output_format='webm'` : la sortie webm transparente ignore ce paramètre.

Image facultative utilisée comme filigrane superposé dans la vidéo générée.

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

Exécuter cette requête

Votre clé reste dans ce navigateur : elle est envoyée uniquement à la Doitong API et enregistrée dans localStorage uniquement si vous cochez Mémoriser. Obtenir une clé API

À propos de Heygen v5 Digital Twin

Crée une vidéo d'avatar parlant à partir de texte (`prompt` et `voice`) ou d'un `audio_url` pour la synchronisation labiale. Sélectionnez un `avatar` nommé, un mode `fit` contain ou cover, et une résolution de 720p, 1080p ou 4k. `output_format` peut être mp4 ou webm ; webm est transparent. Les options incluent la composition d'arrière-plan, un filigrane et un fichier de sous-titres SRT associé.

Paramètres

Envoyez soit le nom canonique, soit le nom natif, mais pas les deux. Noms canoniques

NomType Par défautAutorisé Description
avatarfacultatif
Typestring | null
Par défautAbigail Sofa Front
Nom identifiant un avatar compatible avec Avatar V.
promptfacultatif
Typestring | null
Texte parlé par l'avatar ; requis si `audio_url` est omis.
voicefacultatif
Typeenum
Par défautWarm Pro Narrator
Warm Pro NarratorChill BrianIvyJohn DoeMonika SogamHope Archer BrittneyPatrickDavid CastlemoreMichael CAdam Stone JuniperCassidy Jessica Anne BogartArabella
+86 de plusAndrewSpuds 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
Sélection de la voix de l'avatar par nom pour la synthèse vocale ; s'applique uniquement sans `audio_url`.
audio_urlfacultatif audio
Typeurl · audio
Source de synchronisation labiale fournie sous forme d'URL de fichier audio HTTP(S), remplaçant la synthèse vocale lorsqu'elle est présente. Ni `prompt` ni `voice` ne sont utilisés dans ce cas.
fitfacultatif
Typeenum
Par défautcover
containcover
Choisissez le cadrage de l'avatar : 'cover' remplit l'image de sortie mais peut rogner l'avatar, tandis que 'contain' affiche l'avatar entier mais peut ajouter des bandes noires.
remove_backgroundfacultatif
Typeboolean
Par défautfalse
Suppression de l'arrière-plan de l'avatar ; disponible uniquement pour les avatars compatibles avec le détourage.
backgroundfacultatif
Typeobject
Calque d'arrière-plan placé facultativement derrière l'avatar, sauf avec `output_format='webm'` : la sortie webm transparente ignore ce paramètre.
background.typefacultatif
Typeenum
Par défautcolor
colorimage
Type d'arrière-plan : `color` indique une couleur hexadécimale unie, tandis que `image` indique une URL d'image.
background.valuefacultatif
Typestring
Par défaut#FFFFFF
Contenu de l'arrière-plan : une couleur hexadécimale lorsque le type est `color`, ou une URL HTTP(S) lorsque le type est `image`.
watermarkfacultatif
Typeobject
Image facultative utilisée comme filigrane superposé dans la vidéo générée.
watermark.image_urlrequis
Typeurl · image
URL HTTP(S) de l'image du filigrane à superposer à la vidéo.
watermark.scalefacultatif
Typenumber | null
≤ 2, > 0
Taille du filigrane par rapport à la vidéo, supérieure à 0.0 et inférieure ou égale à 2.0.
watermark.opacityfacultatif
Typenumber | null
0 – 1
Niveau de transparence du filigrane : 0.0 est totalement transparent et 1.0 totalement opaque.
watermark.placementfacultatif
Typeenum
top-lefttop-rightbottom-leftbottom-right
Position du filigrane dans la vidéo.
captionfacultatif
Typeboolean
Par défautfalse
Indique si un fichier de sous-titres SRT séparé accompagnant la vidéo est généré.
output_formatfacultatif
Typeenum
Par défautmp4
mp4webm
Sélection du conteneur vidéo ; `webm` active la transparence grâce à la suppression automatique de l'arrière-plan ; dans ce mode, `background` n'a aucun effet.
resolutionfacultatif
Typeenum
Par défaut720p
720p1080p4k
Préréglage de résolution pour la sortie générée.
aspect_ratiofacultatif
Typeenum
Par défaut16:9
16:99:164:55:41:1auto
Sélection du format d'image vidéo : 'auto' demande à HeyGen de lire et de conserver le format source, en utilisant '16:9' s'il n'y parvient pas. Les choix explicites sont '16:9', '9:16', '4:5', '5:4' et '1:1'.
enable_safety_checkerfacultatif
Typeboolean
Par défauttrue
Le filtrage peut être assoupli en définissant false, si l'appelant est autorisé.
requis Nom canonique, également accepté

Les paramètres de fichier acceptent une URL publique https://, un URI data: jusqu’à 10 MB ou le file_url d’un téléversement. Fichiers

Sortie

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"
  }
}
Vos fichiers, votre choixChaque outputs[].url est une copie dans notre stockage : conservée indéfiniment (facturation au Go-mois) ou 7 jours gratuitement, selon le réglage de votre compte ou ?storage=.
Même structure pour chaque modèletype, url, content_type, width, height et duration, pour les images, vidéos et fichiers audio. output est le propre objet de résultat du modèle.
Champs de sortie
video
object {url, content_type, file_name, file_size}Fichier vidéo produit par Avatar V.
caption_file
object {url, content_type, file_name, file_size} | nullFichier de sous-titres SRT produit lorsque `caption=True`, si le service en fournit un.

Pour les agents IA : cette page au format Markdown est disponible à https://doitong.com/fr/developers/models/heygen/avatar5/digital-twin.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt