Passer au contenu

Heygen · Avatar4 · Image to Video

Intégrer

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

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

Obtenir une clé API
HeyGen Synchronisation labiale et avatars Synchronisation labialejusqu’à 1080p #image-to-video

Anime une seule photo de visage en avatar parlant, avec des styles de parole stables ou expressifs

HeyGen · Vidéo

Votre premier résultat apparaîtra ici

Créez 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 pendant 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 au fur et à mesure de vos modifications.

Texte que l’avatar doit prononcer.

•requis image_url
Déposez un fichier ou

Source d’animation fournie sous forme d’URL d’image; choisissez une image où le visage est clairement visible.

audio_url
Déposez un fichier ou

Audio de synchronisation labiale fourni par URL de fichier, prioritaire sur l’invite et la voix lorsqu’il est présent.

resolution par défaut 720p

Préréglage de résolution de la vidéo : 360p, 480p, 540p, 720p ou 1080p.

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 ne le peut pas. Les choix explicites sont '16:9', '9:16', '4:5', '5:4' et '1:1'.

Avancé talking_style · voice · expression · caption · enable_safety_checker · background
talking_style par défaut stable

Style d’animation parlée : 'stable' maintient les mouvements au minimum, tandis que 'expressive' ajoute davantage d’animation.

Nom de la voix utilisé pour sélectionner la voix de l’avatar.

Expression affichée sur le visage.

Paramètres de l’arrière-plan.

POST /run/heygen/avatar4/image-to-video?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.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"

Exécuter cette requête

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

À propos de Heygen · Avatar4 · Image to Video

Transforme une image contenant un visage clair en vidéo d’avatar parlant. Fournissez un `prompt` avec le texte à prononcer et un nom de `voice`, ou une `audio_url`, qui remplace les deux. `talking_style` alterne entre stable (mouvements minimes) et expressive. Vous pouvez aussi définir une expression, un arrière-plan, des sous-titres facultatifs et une résolution de 360p à 1080p.

Paramètres

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

NomType Par défautAutorisé Description
image_urlrequis image
Typeurl · image
Source d’animation fournie sous forme d’URL d’image; choisissez une image où le visage est clairement visible.
promptfacultatif
Typestring | null
Texte que l’avatar doit prononcer.
voicefacultatif
Typeenum
Warm Pro NarratorChill BrianIvyJohn DoeMonika SogamHope Archer BrittneyPatrickDavid CastlemoreMichael CAdam Stone JuniperCassidy Jessica Anne BogartArabella
+86 autresAndrewSpuds 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
Nom de la voix utilisé pour sélectionner la voix de l’avatar.
audio_urlfacultatif audio
Typeurl · audio
Audio de synchronisation labiale fourni par URL de fichier, prioritaire sur l’invite et la voix lorsqu’il est présent.
talking_stylefacultatif
Typeenum
Par défautstable
stableexpressive
Style d’animation parlée : 'stable' maintient les mouvements au minimum, tandis que 'expressive' ajoute davantage d’animation.
expressionfacultatif
Typestring | null
Expression affichée sur le visage.
backgroundfacultatif
Typeobject
Paramètres de l’arrière-plan.
background.typefacultatif
Typeenum
Par défautcolor
colorimagevideo
Sélection du type d’arrière-plan.
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 lorsque le type est 'image' ou 'video'.
resolutionfacultatif
Typeenum
Par défaut720p
360p480p540p720p1080p
Préréglage de résolution de la vidéo : 360p, 480p, 540p, 720p ou 1080p.
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 ne le peut pas. Les choix explicites sont '16:9', '9:16', '4:5', '5:4' et '1:1'.
captionfacultatif
Typeboolean
Par défautfalse
Détermine si la vidéo inclut des sous-titres.
enable_safety_checkerfacultatif
Typeboolean
Par défauttrue
La vérification peut être assouplie 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/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"
  }
}
Vos fichiers, votre choixChaque outputs[].url est une copie dans notre stockage : conservée indéfiniment (facturation par Go-mois) ou pendant 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, les vidéos et les fichiers audio. output est l’objet de résultat propre au modèle.
Champs de sortie
video
object {url, content_type, file_name, file_size}Fichier vidéo résultant.

Plus de modèles : Synchronisation labiale et avatars

Pour les agents IA : cette page en Markdown se trouve à https://doitong.com/fr-CA/developers/models/heygen/avatar4/image-to-video.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt