Créer une vidéo
Générez des vidéos complètes à partir d'une invite textuelle. Décrivez ce que vous voulez, l'IA se charge automatiquement de l'écriture du script, de la sélection de l'avatar, des visuels, de la voix off, du rythme et des sous-titres.
Authentification
Toutes les requêtes nécessitent l'en-tête X-Api-Key. Définissez la variable d'environnement HEYGEN_API_KEY.
curl -X POST "https://api.heygen.com/v1/video_agent/generate" \
-H "X-Api-Key: $HEYGEN_API_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt": "Crée une vidéo de démonstration produit de 60 secondes."}'
Sélection de l'outil
Si les outils MCP HeyGen sont disponibles (mcp__heygen__*), préférez-les aux appels API HTTP directs — ils gèrent automatiquement l'authentification et le formatage des requêtes.
| Tâche | Outil MCP | Solution de repli (API directe) |
|---|---|---|
| Générer une vidéo à partir d'une invite | mcp__heygen__generate_video_agent | POST /v1/video_agent/generate |
| Vérifier le statut / obtenir l'URL de la vidéo | mcp__heygen__get_video | GET /v2/videos/{video_id} |
| Lister les vidéos du compte | mcp__heygen__list_videos | GET /v2/videos |
| Supprimer une vidéo | mcp__heygen__delete_video | DELETE /v2/videos/{video_id} |
Si aucun outil MCP HeyGen n'est disponible, utilisez les appels API HTTP directs comme documenté dans les fichiers de référence.
Workflow par défaut
Utilisez toujours les directives de prompt-optimizer.md pour structurer les invites avec scènes, timing et styles visuels.
Avec les outils MCP :
- Rédigez une invite optimisée en utilisant prompt-optimizer.md → visual-styles.md
- Appelez
mcp__heygen__generate_video_agentavec l'invite et la configuration (duration_sec, orientation, avatar_id) - Appelez
mcp__heygen__get_videoavec le video_id retourné pour interroger le statut et obtenir l'URL de téléchargement
Sans outils MCP (API directe) :
- Rédigez une invite optimisée en utilisant prompt-optimizer.md → visual-styles.md
POST /v1/video_agent/generate— voir video-agent.mdGET /v2/videos/<id>— voir video-status.md
Référence rapide
| Tâche | Outil MCP | Lecture |
|---|---|---|
| Générer une vidéo à partir d'une invite | mcp__heygen__generate_video_agent | prompt-optimizer.md → visual-styles.md → video-agent.md |
| Vérifier le statut / obtenir l'URL de téléchargement | mcp__heygen__get_video | video-status.md |
| Télécharger des fichiers de référence pour l'invite | — | assets.md |
Quand utiliser cette compétence vs Avatar Video
Cette compétence est destinée à la création vidéo basée sur une invite — décrivez ce que vous voulez, l'IA s'occupe du reste.
Si l'utilisateur a besoin d'un contrôle précis sur des avatars spécifiques, des scripts exacts, la configuration voix/arrière-plan par scène, ou la composition multi-scènes, utilisez plutôt la compétence avatar-video.
| L'utilisateur dit | Cette compétence | Compétence Avatar Video |
|---|---|---|
| « Fais-moi une vidéo sur X » | ✓ | |
| « Crée une démo produit » | ✓ | |
| « Je veux que l'avatar Y dise exactement Z » | ✓ | |
| « Vidéo multi-scènes avec différents arrière-plans » | ✓ | |
| « WebM transparent pour composition » | ✓ |
Fichiers de référence
Workflow principal
- references/prompt-optimizer.md - Rédaction d'invites efficaces (workflow principal + règles)
- references/visual-styles.md - 20 styles visuels nommés avec spécifications complètes
- references/prompt-examples.md - Exemple complet de production + modèles prêts à l'emploi
- references/video-agent.md - Détails des points de terminaison de l'API Video Agent
Fondations
- references/video-status.md - Modèles d'interrogation et URLs de téléchargement
- references/webhooks.md - Points de terminaison webhook et événements
- references/assets.md - Téléchargement d'images, vidéos, audio comme références
- references/dimensions.md - Résolutions et ratios d'aspect
- references/quota.md - Système de crédits et limites d'utilisation
Bonnes pratiques
- Optimisez votre invite — La différence entre des résultats médiocres et professionnels dépend entièrement de la qualité de l'invite. Utilisez toujours l'optimiseur de prompt
- Spécifiez la durée — Utilisez
config.duration_secpour une longueur prévisible - Verrouillez l'avatar si nécessaire — Utilisez
config.avatar_idpour une cohérence entre vidéos - Téléchargez des fichiers de référence — Aidez l'agent à comprendre votre marque/produit
- Itérez sur les invites — Affinez en fonction des résultats ; l'agent vidéo est idéal pour des itérations rapides