Communitygithub.com

Vídeo com Avatar

Crie vídeos com avatares de IA tendo controle preciso sobre avatares, vozes, roteiros, cenas e planos de fundo usando a API v2 do HeyGen.

O que é Vídeo com Avatar?

Esta skill capacita agentes de IA a gerar vídeos com avatares realistas usando a API v2 do HeyGen, oferecendo controle granular sobre cada aspecto da produção. Com ela, é possível selecionar avatares e vozes específicos, escrever roteiros exatos, construir vídeos com múltiplas cenas e fundos variados, criar vídeos WebM transparentes para composição, usar fotos como apresentadores, integrar com Remotion e gerar vídeos em lote com especificações precisas. A skill prioriza ferramentas MCP quando disponíveis, mas também fornece endpoints HTTP diretos como fallback. O fluxo de trabalho padrão envolve listar avatares e vozes, estruturar o roteiro, gerar o vídeo e acompanhar o status até a conclusão. É ideal para cenários que exigem controle total, como vídeos de marca consistentes, demonstrações de produtos ou qualquer produção onde o usuário precise que um avatar diga exatamente um texto específico. Para ideias vagas de vídeo, recomenda-se o uso da skill 'create-video', que delega a criação à IA.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que Vídeo com Avatar faz?

Crie vídeos com avatares de IA com controle total sobre avatares, vozes, roteiros, cenas e planos de fundo. Construa vídeos de cena única ou múltiplas cenas com configuração exata usando a API /v2/video/generate do HeyGen.

Autenticação

Todas as requisições exigem o cabeçalho X-Api-Key. Defina a variável de ambiente HEYGEN_API_KEY.

curl -X GET "https://api.heygen.com/v2/avatars" \
  -H "X-Api-Key: $HEYGEN_API_KEY"

Seleção de Ferramentas

Se as ferramentas MCP do HeyGen estiverem disponíveis (mcp__heygen__*), prefira-as em vez de chamadas HTTP diretas — elas lidam com autenticação e formatação de requisições automaticamente.

TarefaFerramenta MCPFallback (API Direta)
Verificar status do vídeo / obter URLmcp__heygen__get_videoGET /v2/videos/{video_id}
Listar vídeos da contamcp__heygen__list_videosGET /v2/videos
Excluir um vídeomcp__heygen__delete_videoDELETE /v2/videos/{video_id}

A geração de vídeo (POST /v2/video/generate) e a listagem de avatares/vozes são feitas via chamadas de API diretas — veja os arquivos de referência abaixo.

Fluxo de Trabalho Padrão

  1. Listar avatares — GET /v2/avatars → escolha um avatar, visualize-o, anote avatar_id e default_voice_id. Veja avatars.md
  2. Listar vozes (se necessário) — GET /v2/voices → escolha uma voz que corresponda ao gênero/idioma do avatar. Veja voices.md
  3. Escrever o roteiro — Estruture cenas com um conceito cada. Veja scripts.md
  4. Gerar o vídeo — POST /v2/video/generate com avatar, voz, roteiro e plano de fundo por cena. Veja video-generation.md
  5. Acompanhar até a conclusão — GET /v2/videos/{video_id} até o status ser completed. Veja video-status.md

Referência Rápida

TarefaLeia
Listar e visualizar avataresavatars.md
Listar e selecionar vozesvoices.md
Escrever e estruturar roteirosscripts.md
Gerar vídeo (cena única ou múltiplas)video-generation.md
Adicionar planos de fundo personalizadosbackgrounds.md
Adicionar legendas / subtítuloscaptions.md
Adicionar sobreposições de textotext-overlays.md
Criar vídeo WebM transparentevideo-generation.md (seção WebM)
Usar modelostemplates.md
Criar avatar a partir de fotophoto-avatars.md
Verificar status do vídeo / downloadvideo-status.md
Enviar ativos (imagens, áudio)assets.md
Usar com Remotionremotion-integration.md
Configurar webhookswebhooks.md

Quando Usar Esta Skill vs. Criar Vídeo

Esta skill é para controle preciso — você escolhe o avatar, escreve o roteiro exato, configura cada cena.

Se o usuário apenas deseja descrever uma ideia de vídeo e deixar a IA cuidar do resto (roteiro, avatar, visuais), use a skill create-video.

Usuário DizSkill Criar VídeoEsta Skill
"Faça um vídeo sobre X"✓
"Crie uma demonstração de produto"✓
"Quero que o avatar Y diga exatamente Z"✓
"Vídeo com múltiplas cenas e fundos diferentes"✓
"WebM transparente para composição"✓
"Use esta voz específica para meu roteiro"✓
"Gere vídeos em lote com especificações exatas"✓

Arquivos de Referência

Criação Principal de Vídeo

Personalização de Vídeo

Funcionalidades Avançadas

Integração

Fundamentos

Melhores Práticas

  1. Visualize avatares antes de gerar — Baixe preview_image_url para que o usuário veja o avatar antes de confirmar
  2. Use a voz padrão do avatar — A maioria dos avatares tem um default_voice_id pré-combinado para resultados naturais
  3. Fallback: combine gênero manualmente — Se não houver voz padrão, garanta que os gêneros do avatar e da voz coincidam
  4. Use modo de teste para desenvolvimento — Defina test: true para evitar consumir créditos (o resultado terá marca d'água)
  5. Defina timeouts generosos — A geração de vídeo geralmente leva de 5 a 15 minutos, às vezes mais
  6. Valide entradas — Verifique se os IDs do avatar e da voz existem antes de gerar

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.

Habilidades Relacionadas