# Fiche connecteur HeyGen
Catalogue Pipedream : connexion du compte et droits nécessaires. Les actions réellement utilisables sont vérifiées dans Bruno lors de la connexion. Les déclencheurs sont documentés à titre de référence et ne sont pas activés automatiquement dans Bruno.
Les noms et données des exemples sont fictifs ; toute exécution reste soumise aux droits et aux validations du connecteur.

## HeyGen
URL : https://get-bruno.com/features/connectors/heygen
Référence texte : https://get-bruno.com/features/connectors/heygen/reference.txt
Origine : Catalogue Pipedream
Statut : Catalogue Pipedream — connexion à vérifier
Catégories : Intelligence artificielle
Description : HeyGen sert à créer des vidéos assistées par IA et à suivre leur génération. Le service expose aussi des listes de ressources de référence comme les apparences d'avatar, les voix, les modèles et les vidéos.
Authentification : API key
Présentation : HeyGen sert à créer des vidéos assistées par IA et à suivre leur génération. Le service expose aussi des listes de ressources de référence comme les apparences d'avatar, les voix, les modèles et les vidéos.
Usage : Retrouver l'identifiant d'une apparence d'avatar avant génération
Exemple de demande : Je veux préparer une vidéo pour l'apparence d'avatar « Présentatrice bureau » et j'ai besoin de son identifiant disponible dans HeyGen.
Résultat attendu : Une liste d'apparences d'avatar est renvoyée avec les champs utiles pour choisir l'identifiant correct.
À préciser : Type d'avatar recherché ; Nom ou style attendu pour l'avatar ; Filtre public ou privé si nécessaire
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/heygen/actions/list-avatar-look-id-options
Usage : Suivre une vidéo déjà lancée
Exemple de demande : Je veux vérifier l'état de la vidéo HeyGen « Accueil produit » et retrouver son lien quand elle est terminée.
Résultat attendu : L'état de la vidéo est relu, puis le lien de la vidéo est fourni une fois la vidéo terminée.
À préciser : Identifiant de la vidéo ; Nom métier de la vidéo si l'identifiant est déjà connu
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/heygen/actions/list-videos ; https://pipedream.com/apps/heygen/actions/retrieve-video-link
Usage : Choisir une voix avant la production
Exemple de demande : Je veux trouver une voix espagnole féminine pour la vidéo « Message clients » avant de préparer le champ Voice ID.
Résultat attendu : Une page de voix disponibles est renvoyée avec des options filtrées par langue et par genre.
À préciser : Langue souhaitée ; Genre vocal souhaité
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/heygen/actions/list-voice-id-options
Limites propres au service : Aucune limite native n'est fournie dans cette fiche source. La liste des vidéos peut ne pas inclure les vidéos créées dans l'application web HeyGen. Le lien vidéo n'est disponible qu'une fois la vidéo terminée. Si une génération échoue, l'état passe à failed, le lien reste nul et il ne faut pas continuer à interroger la vidéo.
Vocabulaire français : Lister les options d'identifiant d'apparence d'avatar — Récupère les apparences d'avatar disponibles pour choisir un identifiant utilisable dans les champs Avatar Look ID. (https://pipedream.com/apps/heygen/actions/list-avatar-look-id-options)
Vocabulaire français : Lister les options d'événements personnalisés — Récupère tous les types d'événements webhook disponibles pour les champs Custom Events. (https://pipedream.com/apps/heygen/actions/list-custom-events-options)
Vocabulaire français : Lister les options d'identifiant de modèle — Récupère les modèles disponibles pour choisir un identifiant utilisable dans les champs Template ID. (https://pipedream.com/apps/heygen/actions/list-template-id-options)
Vocabulaire français : Lister les vidéos — Récupère une page de vidéos avec leur identifiant, leur état et leurs liens de téléchargement une fois terminées. (https://pipedream.com/apps/heygen/actions/list-videos)
Vocabulaire français : Lister les options d'identifiant de voix — Récupère les voix disponibles pour choisir un identifiant utilisable dans les champs Voice ID. (https://pipedream.com/apps/heygen/actions/list-voice-id-options)
Vocabulaire français : Récupérer le lien d'une vidéo — Obtient un lien pour une vidéo HeyGen donnée quand son état est terminé. (https://pipedream.com/apps/heygen/actions/retrieve-video-link)
Vocabulaire français : Nouveau événement vidéo avatar personnalisé — Déclenche un événement quand un événement vidéo avatar personnalisé survient. (https://pipedream.com/apps/heygen/triggers/new-avatar-video-custom-event)
Vocabulaire français : Nouvelle erreur de vidéo avatar — Déclenche un événement quand une vidéo HeyGen échoue pendant le traitement. (https://pipedream.com/apps/heygen/triggers/new-avatar-video-failure)
Vocabulaire français : Nouvelle vidéo avatar réussie — Déclenche un événement quand une vidéo avatar est générée avec succès. (https://pipedream.com/apps/heygen/triggers/new-avatar-video-success)
- action : List Avatar Look ID Options — Retrieves a page of available avatar looks, whose id can be used for Avatar Look ID fields. Lists photo_avatar looks by default; set Avatar Type to digital_twin or studio_avatar for other kinds, and Ownership to public or private to narrow further. Pass Fields to keep the response small. If has_more is true, pass next_token as the Token to get the next page. Example: Limit 2 and Fields ["id", "name"] returns {"data": [{"id": "look_1", "name": "Office look"}, {"id": "look_2", "name": "Outdoor look"}], "has_more": true, "next_token": "abc"} . See the documentation (https://pipedream.com/apps/heygen/actions/list-avatar-look-id-options)
- action : List Custom Events Options — Retrieves all available webhook event types, whose event_type can be used for Custom Events fields. The full list is returned in a single response (no paging). Example: returns {"data": [{"event_type": "avatar_video.success", "description": "Fires when an avatar video finishes"}]} . See the documentation (https://pipedream.com/apps/heygen/actions/list-custom-events-options)
- action : List Template ID Options — Retrieves a page of available templates, whose id can be used for Template ID fields. If has_more is true, pass next_token as the Token to get the next page. Example: Limit 2 returns {"data": [{"id": "tpl_1", "name": "Product launch", "aspect_ratio": "16:9"}, {"id": "tpl_2", "name": "Weekly update", "aspect_ratio": "9:16"}], "has_more": true, "next_token": "abc"} . See the documentation (https://pipedream.com/apps/heygen/actions/list-template-id-options)
- action : List Videos — Retrieves a page of videos, newest first, with their id , status , and download links once completed. Use this to find a video ID for other actions. Note: the HeyGen v3 list may not include videos created in the HeyGen web app (it can return an empty list even when such videos exist); if you already know a video's ID, use Retrieve Video Link instead, which works for any video ID. Pass Fields to keep the response small. If has_more is true, pass next_token as the Token to get the next page. Example: Title Onboarding with Limit 2 and Fields ["id", "title", "status"] returns {"data": [{"id": "v_123", "title": "Onboarding intro", "status": "completed"}, {"id": "v_122", "title": "Onboarding part 2", "status": "processing"}], "has_more": true, "next_token": "abc"} . See the documentation (https://pipedream.com/apps/heygen/actions/list-videos)
- action : List Voice ID Options — Retrieves a page of available voices, whose voice_id can be used for Voice ID fields. Lists public voices by default; set Voice Type to private to list your own cloned voices, and use Language and Gender to narrow results instead of paging through every voice. If has_more is true, pass next_token as the Token to get the next page. Example: Language Spanish , Gender female and Limit 2 returns {"data": [{"voice_id": "voice_1", "name": "Camila", "language": "Spanish", "gender": "female"}, {"voice_id": "voice_2", "name": "Lucia", "language": "Spanish", "gender": "female"}], "has_more": true, "next_token": "abc"} . See the documentation (https://pipedream.com/apps/heygen/actions/list-voice-id-options)
- action : Retrieve Video Link — Fetches a link for a specific heygen video. The link is only available once the video status is completed . Works for any video ID, including videos created in the HeyGen web app. If you don't have the video ID, use the List Videos action first (note it may not list web-app videos). Example: Video ID v_123 returns {"data": {"id": "v_123", "status": "completed", "video_url": "https://..."}, "video_link": "https://..."} ; while the video is still processing, video_link is null and data.status is processing (check again later). If generation failed, data.status is failed , video_link is null, and failure_code and failure_message explain why; the video will never complete, so do not keep polling. See the documentation (https://pipedream.com/apps/heygen/actions/retrieve-video-link)
- trigger : New Avatar Video Custom Event (Instant) — Emit new event when a specific avatar video event occurs. The user can define a custom set of event(s) to trigger. See the documentation (https://pipedream.com/apps/heygen/triggers/new-avatar-video-custom-event)
- trigger : New Avatar Video Failure (Instant) — Emit new event when a Heygen video fails during processing. See the documentation (https://pipedream.com/apps/heygen/triggers/new-avatar-video-failure)
- trigger : New Avatar Video Success (Instant) — Emit new event when a new avatar video has been successfully generated. See the documentation (https://pipedream.com/apps/heygen/triggers/new-avatar-video-success)