Créer une vidéo
Générez des vidéos complètes à partir d'une invite textuelle. Décrivez ce que vous voulez et l'IA s'occupe automatiquement de l'écriture du script, de la sélection des avatars, 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éez une vidéo de démonstration produit de 60 secondes."}'
Sélection des outils
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 de la vidéo / obtenir l'URL | 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.
Flux de travail par défaut
Utilisez toujours les directives de prompt-optimizer.md pour structurer les invites avec des scènes, des durées et des 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 renvoyé 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 de la vidéo / 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 plutôt que la vidéo avatar
Cette compétence est destinée à la création vidéo basée sur une invite — décrivez ce que vous voulez, et 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ène, utilisez la compétence avatar-video à la place.
| L'utilisateur dit | Cette compétence | Compétence Vidéo Avatar |
|---|---|---|
| « 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ène avec différents arrière-plans » | ✓ | |
| « WebM transparent pour compositing » | ✓ |
Fichiers de référence
Flux de travail principal
- references/prompt-optimizer.md - Rédiger des invites efficaces (flux de travail principal + règles)
- references/visual-styles.md - 20 styles visuels nommés avec spécifications complètes
- references/prompt-examples.md - Exemple complet d'invite de production + modèles prêts à l'emploi
- references/video-agent.md - Détails du point de terminaison API Video Agent
Fondamentaux
- references/video-status.md - Modèles d'interrogation et URLs de téléchargement
- references/webhooks.md - Points de terminaison et événements webhook
- 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 d'invite
- Spécifiez la durée — Utilisez
config.duration_secpour une longueur prévisible - Verrouillez l'avatar si nécessaire — Utilisez
config.avatar_idpour la cohérence entre les 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