Intégration API HeyGen
Nous développons votre connecteur HeyGen
Nous branchons HeyGen à votre produit pour générer une vidéo d'onboarding, de formation ou de relance à chaque nouveau client, sans studio.
- Équipe produit senior
- connecteurs vidéo IA en production
- du cadrage au monitoring
À quoi sert l'API HeyGen et dans quels cas générer des vidéos par programme ?
HeyGen permet de générer des vidéos avec un avatar parlant à partir d'un texte, dans plus de trente langues. L'API permet à votre application de produire automatiquement une vidéo personnalisée : avec le nom du destinataire, un produit, une langue, sans studio ni intervention humaine. On l'intègre dans des plateformes de formation qui génèrent des leçons personnalisées, des outils de prospection commerciale qui créent une vidéo par prospect, ou des applications e-commerce qui produisent des présentations produit localisées à la demande.
Ce que nos clients construisent sur l'API HeyGen
Vidéo d'onboarding à l'activation du compte
Nom, produit, langue. Déclenchée par l'événement métier, livrée quand elle est prête, stockée chez vous.
Module e-learning régénéré à chaque script
Trois langues, lipsync. Une mise à jour de script n'attend plus un re-shoot.
Message du dirigeant, avatar consenti
Offre trimestrielle. Accord écrit, révocable, appel consent API. Un avatar stock évite le sujet.
Tutoriel terrain versionné dans l'app magasin
« Voici comment scanner le colis ». Batch de variantes (une par agence) sur le même template.
Ce que ça change dans votre production
La technique au service d'un résultat mesurable : une variante sans studio, un consentement posé, une vidéo chez vous.
Le coût d'une variante tombe
Onboarding, relance, formation : nom, produit, langue, sans journée de tournage. Le métier déclenche, la vidéo arrive.
L'export n'attend plus un re-shoot
Traduction et lipsync. Un webinaire existant part vers une filiale ES/DE sans nouveau plateau.
Le consentement passe avant le clone
Visage d'un dirigeant ou d'un formateur : accord écrit, borné, révocable. Même réflexe que pour une voix clonée.
Le fichier vit dans votre stockage
Dès que la vidéo est prête, on la télécharge chez vous. L'URL éditeur n'est pas traitée comme un hébergement éternel.
Comment nous livrons votre connecteur HeyGen
Cadrage
Avatar API (contrôle marque) ou Video Agent (prompt). Consentement, langues, volume. La grille de prix se relit au cadrage, nous ne l'inventons pas.
Prototype
Un template, vos phrases, vos noms de marque. Vous validez le rendu, pas nous. Lexique de prononciation FR.
Développement
Job asynchrone, video_id persisté, HMAC raw, dédup Heygen-Event-Id, 2xx < 10 s, stockage sur votre bucket, repli si fail.
Monitoring
avatar_video.fail, file GPU, secret webhook (one-shot à la création). Rotation = fenêtre de vérifications en échec.
Ce que permet l'API HeyGen
- Vidéos avatar et templates
- Contrôle de marque : look, voix, script. Le devis d'une Avatar API n'est pas celui d'un Video Agent au prompt.
- Video Agent
- Prompt vers vidéo. Plus rapide à prototyper, moins de contrôle. Deux produits, deux cadrages.
- Traduction et lipsync
- 30+ langues. Un webinaire existant, une filiale, sans re-shoot. Batch jusqu'à 100 variantes.
- Webhooks signés
- POST /v3/webhooks/endpoints, secret whsec_ one-shot. HMAC du corps brut seulement : la dédup Event-Id est la défense replay.
Le vocabulaire de l'API HeyGen
- Heygen-Signature
- HMAC-SHA256 hex du corps brut. Heygen-Timestamp à rejeter au-delà d'environ 5 minutes. Le timestamp n'entre pas dans le HMAC : la dédup Heygen-Event-Id est obligatoire.
- whsec_
- Secret webhook, montré uniquement à la création ou à la rotation. Le perdre = rotation, fenêtre de vérifications en échec (doc officielle). Hors git.
- Video Agent
- Prompt vers vidéo. Moins de contrôle marque qu'une Avatar API (look, voix, script). Deux devis, pas un bouton.
- callback_url
- Alternative one-shot à la création (callback_id). Moins souple que l'abonnement webhooks pour un produit. Utile en prototype.
- Consentement avatar
- POST /v3/avatars/{group_id}/consent. Droit à l'image : accord écrit, durée, périmètre, révocable. Un avatar stock évite le sujet juridique.
- Asynchrone GPU
- Dizaines de secondes à minutes. Ce n'est pas un agent vocal téléphonique. Un timeout HTTP sur create est normal. Le métier est le webhook.
Les contraintes réelles de l'API HeyGen
Ce n'est pas du temps réel téléphonique
Fichier vidéo livré plus tard. Le temps réel voix est la fiche Agent vocal / ElevenLabs. Vendre du live avec HeyGen est un mauvais cadrage.
Le secret webhook est one-shot
Création ou rotation seulement. Le perdre impose une rotation et une fenêtre de signatures en échec. Hors git, procédure écrite, pas un secret collé dans un ticket.
HMAC sur le body only
Dédup Heygen-Event-Id obligatoire. Timestamp hors HMAC : un replay avec timestamp frais passe si on ne déduplique pas. ACK 2xx en 10 s.
Prix et TTL d'URL : au cadrage
Nous ne publions pas de grille 2026 ni de durée de vie d'URL. On télécharge vers votre bucket. Résidence des rendus et DPA : à relire, non affirmés ici.
Avatar API ou Video Agent HeyGen ?
Deux produits dans la même API v3. Le bon dépend du contrôle de marque, pas de la vitesse du premier prompt.
| Critère | Avatar APIContrôle marque | Video AgentPrompt |
|---|---|---|
| Pilotage | Look, voix, script | Prompt vers vidéo |
| Marque | Serrée | Plus large, moins prévisible |
| Consentement visage | Souvent le sujet (CEO, formateur) | Selon l'avatar choisi |
| Webhook | avatar_video.* | video_agent.* |
| Prototype | Plus de cadrage | Plus rapide |
| Batch | Variantes contrôlées, jusqu'à 100 | Variantes au prompt |
| Le bon cas | Onboarding, formation, offre | Exploration, volume de tests |
Les deux restent asynchrones. Ni l'un ni l'autre n'est un callbot. callback_url one-shot vs abonnement webhooks : le produit prend l'abonnement, le prototype peut rester one-shot.
Ce que nous mesurons sur une intégration HeyGen
Les autres briques IA
HeyGen se combine plus souvent qu'il ne se remplace. Ces options se discutent au cadrage.
HeyGenNous développons votre connecteur HeyGenCette page
GeminiLe texte et l'image encore, avant de passer à l'avatar.
MistralLe script et l'OCR, en amont de la vidéo, inférence UE.
ElevenLabsNous développons votre connecteur ElevenLabsTranscriptionNous développons votre connecteur de transcription
Anthropic (Claude)Un modèle qui appelle vos outils, pas un chat de plus
OpenAILe modèle écrit dans vos outils, il ne discute pas
CursorL'agent atteint vos outils internes, pas juste votre codeOn combine HeyGen avec
La stack qui entoure HeyGen sur nos projets.
HeyGen : vos questions
Quatre étapes. Trancher Avatar API ou Video Agent. Poser le consentement avant tout clone de visage (accord écrit, appel consent). Create asynchrone, persister video_id, webhooks HMAC (corps brut, Event-Id, ACK < 10 s), télécharger le fichier vers votre bucket. File d'attente et plafond GPU. La partie sensible n'est pas POST /v3/videos, c'est le secret one-shot, la dédup, et de ne pas traiter l'URL HeyGen comme un stockage permanent (TTL relu au cadrage).
Oui, sous conditions. Droit à l'image : accord écrit, durée, périmètre, révocable, plus POST /v3/avatars/{group_id}/consent. Un avatar stock évite le sujet. Cloner sans preuve, c'est le même risque que le clonage vocal : ça se cadre avant la première génération, pas après la campagne. Le registre des consentements (qui, jusqu'à quand, preuve) est un livrable, pas une case à cocher dans un devis.
Non. HeyGen livre un fichier vidéo plus tard (secondes à minutes). Un agent vocal (Twilio, temps réel, ElevenLabs) tient une conversation. Les webhooks HeyGen (success/fail, 10 s, retries 24 h) sont un protocole d'intégration asynchrone, pas une ligne téléphonique. Si le besoin est de décrocher, c'est la fiche Agent vocal IA. Si le besoin est une variante d'onboarding, c'est ici. Mélanger les deux dans un devis est l'erreur de cadrage habituelle.
Nous ne publions pas de grille 2026 : elle se relit sur heygen.com/pricing au cadrage du projet. Le coût réel est celui du compute GPU, du volume de variantes et des échecs (repli template). Nous posons un plafond de concurrence et un budget, une file métier, et nous vous remettons la décomposition avant de développer. Inventer un prix ou un TTL d'URL ici serait un faux cadrage : les deux se vérifient sur les pages éditeur courantes.
Un premier flux utile, une vidéo d'onboarding sur template avec webhook et stockage interne, se livre en deux à trois semaines. Avatar consenti du dirigeant, traduction multi-langues, batch 100 variantes et registre de consentement demandent plutôt six à huit semaines. La durée dépend du produit (Avatar vs Video Agent) et du volume GPU. Nous cadrons le périmètre en amont et vous donnons une estimation ferme avant de commencer.
Un projet d'intégration HeyGen ?
Parlons-en. 30 minutes pour cadrer avatar ou Video Agent, le consentement, et vous dire franchement ce que l'asynchrone tient.
Parler de mon projet HeyGen