Communitygithub.com

Vidéo Avatar

Créez des vidéos AI avec des avatars, en contrôlant précisément les avatars, les voix, les scripts, les scènes et les arrière-plans via l'API v2 de HeyGen.

Qu'est-ce que Vidéo Avatar ?

Cette compétence permet de créer des vidéos AI avec des avatars grâce à l'API v2 de HeyGen, en offrant un contrôle total sur chaque aspect de la production. Elle est idéale pour les développeurs et utilisateurs d'agents AI qui souhaitent choisir un avatar et une voix spécifiques, écrire des scripts exacts, construire des vidéos multi-scènes avec différents arrière-plans, ou générer des vidéos WebM transparentes pour le compositing. La compétence prend en charge les appels d'API directs ainsi que les outils MCP (Model Context Protocol) lorsque ceux-ci sont disponibles, simplifiant l'authentification et le formatage des requêtes. Elle inclut un flux de travail par défaut en cinq étapes : lister les avatars, sélectionner les voix, écrire le script, générer la vidéo, puis interroger son état jusqu'à sa finalisation. En plus de la création de base, la compétence gère des fonctionnalités avancées comme les superpositions de texte, les sous-titres, les modèles, la création d'avatars à partir de photos, et l'intégration avec Remotion. Elle fournit également des conseils de bonnes pratiques, comme la prévisualisation des avatars avant génération et l'utilisation du mode test pour éviter de consommer des crédits.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Zuhair-01/claude-skills-and-systems/tree/HEAD/skills/avatar-video

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait Vidéo Avatar ?

Créez des vidéos AI avec des avatars, en contrôlant totalement les avatars, les voix, les scripts, les scènes et les arrière-plans. Construisez des vidéos simples ou multi-scènes avec une configuration précise en utilisant l'API /v2/video/generate de HeyGen.

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 GET "https://api.heygen.com/v2/avatars" \
  -H "X-Api-Key: $HEYGEN_API_KEY"

Sélection d'outil

Si les outils MCP HeyGen sont disponibles (mcp__heygen__*), préférez-les aux appels d'API HTTP directs — ils gèrent automatiquement l'authentification et le formatage des requêtes.

TâcheOutil MCPAlternative (API Directe)
Vérifier le statut de la vidéo / obtenir l'URLmcp__heygen__get_videoGET /v2/videos/{video_id}
Lister les vidéos du comptemcp__heygen__list_videosGET /v2/videos
Supprimer une vidéomcp__heygen__delete_videoDELETE /v2/videos/{video_id}

La génération de vidéo (POST /v2/video/generate) et le listage des avatars/voix se font via des appels d'API directs — voir les fichiers de référence ci-dessous.

Flux de travail par défaut

  1. Lister les avatars — GET /v2/avatars → choisissez un avatar, prévisualisez-le, notez avatar_id et default_voice_id. Voir avatars.md
  2. Lister les voix (si nécessaire) — GET /v2/voices → choisissez une voix correspondant au genre/langue de l'avatar. Voir voices.md
  3. Écrire le script — Structurez les scènes avec un concept par scène. Voir scripts.md
  4. Générer la vidéo — POST /v2/video/generate avec avatar, voix, script et arrière-plan par scène. Voir video-generation.md
  5. Interroger jusqu'à la fin — GET /v2/videos/{video_id} jusqu'à ce que le statut soit completed. Voir video-status.md

Référence rapide

TâcheLire
Lister et prévisualiser les avatarsavatars.md
Lister et sélectionner les voixvoices.md
Écrire et structurer les scriptsscripts.md
Générer une vidéo (simple ou multi-scène)video-generation.md
Ajouter des arrière-plans personnalisésbackgrounds.md
Ajouter des légendes / sous-titrescaptions.md
Ajouter des superpositions de textetext-overlays.md
Créer une vidéo WebM transparentevideo-generation.md (section WebM)
Utiliser des modèlestemplates.md
Créer un avatar à partir d'une photophoto-avatars.md
Vérifier le statut / télécharger une vidéovideo-status.md
Télécharger des ressources (images, audio)assets.md
Utiliser avec Remotionremotion-integration.md
Configurer des webhookswebhooks.md

Quand utiliser cette compétence plutôt que Créer une vidéo

Cette compétence est destinée à un contrôle précis — vous choisissez l'avatar, écrivez le script exact, configurez chaque scène.

Si l'utilisateur souhaite simplement décrire une idée de vidéo et laisser l'IA gérer le reste (script, avatar, visuels), utilisez plutôt la compétence create-video.

L'utilisateur ditCompétence Créer une vidéoCette compétence
"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 compositing"✓
"Utilise cette voix spécifique pour mon script"✓
"Génère des vidéos en lot avec des spécifications exactes"✓

Fichiers de référence

Création vidéo de base

Personnalisation vidéo

Fonctionnalités avancées

Intégration

Fondations

Bonnes pratiques

  1. Prévisualisez les avatars avant de générer — Téléchargez preview_image_url pour que l'utilisateur puisse voir l'avatar avant de s'engager
  2. Utilisez la voix par défaut de l'avatar — La plupart des avatars ont un default_voice_id pré-associé pour des résultats naturels
  3. Alternative : faites correspondre le genre manuellement — Si aucune voix par défaut, assurez-vous que les genres de l'avatar et de la voix correspondent
  4. Utilisez le mode test pour le développement — Définissez test: true pour éviter de consommer des crédits (la sortie sera filigranée)
  5. Définissez des délais d'attente généreux — La génération vidéo prend souvent 5 à 15 minutes, parfois plus
  6. Validez les entrées — Vérifiez que les ID d'avatar et de voix existent avant de générer

Individual skills in this repo

This repo contains 9 individual skills — each has its own dedicated page.

Zuhair-01/claude-skills-and-systems

Generate Mandarin and multilingual narration with Volcengine Doubao Speech 2.0. Use when creating Chinese voiceovers, when the user prefers Doubao/Volcengine/火山引擎/豆包 TTS, or when narration needs character-level timestamp metadata for subtitles.

Zuhair-01/claude-skills-and-systems

Edit existing videos using AI — remix style, upscale, remove background, and add audio via fal.ai's hosted video models.

Zuhair-01/claude-skills-and-systems

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

Zuhair-01/claude-skills-and-systems

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

Zuhair-01/claude-skills-and-systems

Read-only queue dashboard for workspace-aware ship. (gstack)

Zuhair-01/claude-skills-and-systems

Generate HeyGen presenter videos via the v3 Video Agent pipeline — handles Frame Check (aspect ratio correction), prompt engineering, avatar resolution, and voice selection. Required for any HeyGen video generation. Replaces deprecated endpoints with v3. Use when: (1) generating any HeyGen video (via API or otherwise), (2) sending a personalized video message (outreach, update, announcement, pitch, knowledge), (3) creating a HeyGen presenter-led explainer, tutorial, or product demo with a human face, (4) "make a video of me saying...", "send a video to my leads", "record an update for my team", "create a video pitch", "make a loom-style message", "I want to appear in this video", "generate a HeyGen video", "make a talking head video". Accepts avatar_id from heygen-avatar for identity-first HeyGen videos, or uses a stock presenter. Returns video share URL + HeyGen session URL for iteration. Chain signal: when the user wants to create/design an avatar AND make a video in the same request, run heygen-avatar f...

Zuhair-01/claude-skills-and-systems

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

Zuhair-01/claude-skills-and-systems

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

Zuhair-01/claude-skills-and-systems

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

Skills associés