# Heygen > [OBSOLETO] Usa create-video para generación de vídeo por prompt o avatar-video para control preciso de avatar y escena. Este skill heredado combina ambos flujos. Fuente: https://skillsagentes.com/skills/calesthio/openmontage/heygen Markdown: https://skillsagentes.com/skills/calesthio/openmontage/heygen.md Repositorio: https://github.com/calesthio/OpenMontage Autor: calesthio Licencia: AGPL-3.0 Actualizado: hace 4 meses Coste de contexto: 54 tok instalada, 1.5k tok al activarse, 57.7k tok con todos los archivos del bundle Bundle: 21 archivos, 225 KB Permisos que pide: mcp__heygen__* ## Instalación Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina. ```bash # Claude Code npx -y skills add calesthio/OpenMontage --skill heygen --agent claude-code # Cursor npx -y skills add calesthio/OpenMontage --skill heygen --agent cursor # Codex npx -y skills add calesthio/OpenMontage --skill heygen --agent codex # Gemini CLI npx -y skills add calesthio/OpenMontage --skill heygen --agent gemini # Windsurf npx -y skills add calesthio/OpenMontage --skill heygen --agent windsurf # Cline npx -y skills add calesthio/OpenMontage --skill heygen --agent cline ``` ## Qué hace - Skill heredado que juntaba los dos flujos de HeyGen: generación por prompt y control preciso de avatar y escena - Marcado como obsoleto: los skills nuevos y enfocados dan mejor guía - Mantiene selección de herramienta, flujo por defecto y los archivos de referencia de la API ## Cuándo usarla - Solo por compatibilidad con proyectos que aún apunten a este skill heredado ## Cuándo no - Generación de vídeo por prompt: usa `create-video` - Control preciso de avatar y escena: usa `avatar-video` ## Antes de instalar - Obsoleto. Necesita `HEYGEN_API_KEY` y `mcp__heygen__*`, pero conviene migrar a `create-video` o `avatar-video`. ## Archivos - SKILL.md — 6 KB - references/assets.md — 9 KB - references/authentication.md — 5 KB - references/avatars.md — 15 KB - references/backgrounds.md — 7 KB - references/captions.md — 5 KB - references/dimensions.md — 7 KB - references/photo-avatars.md — 24 KB - references/prompt-examples.md — 8 KB - references/prompt-optimizer.md — 12 KB - references/quota.md — 5 KB - references/remotion-integration.md — 18 KB - references/scripts.md — 10 KB - references/templates.md — 10 KB - references/text-overlays.md — 7 KB - references/video-agent.md — 10 KB - references/video-generation.md — 22 KB - references/video-status.md — 13 KB - references/visual-styles.md — 15 KB - references/voices.md — 12 KB - references/webhooks.md — 9 KB ## SKILL.md Reproducido tal cual desde calesthio/OpenMontage bajo AGPL-3.0. Esta sección es el documento original y está en inglés. # HeyGen API (Deprecated) > **This skill is deprecated.** Use the focused skills instead: > - **`create-video`** — Generate videos from a text prompt (Video Agent API) > - **`avatar-video`** — Build videos with specific avatars, voices, scripts, and scenes (v2 API) This skill remains for backward compatibility but will be removed in a future release. --- AI avatar video creation API for generating talking-head videos, explainers, and presentations. ## Tool Selection If HeyGen MCP tools are available (`mcp__heygen__*`), **prefer them** over direct HTTP API calls — they handle authentication and request formatting automatically. | Task | MCP Tool | Fallback (Direct API) | |------|----------|----------------------| | Generate video from prompt | `mcp__heygen__generate_video_agent` | `POST /v1/video_agent/generate` | | Check video status / get URL | `mcp__heygen__get_video` | `GET /v2/videos/{video_id}` | | List account videos | `mcp__heygen__list_videos` | `GET /v2/videos` | | Delete a video | `mcp__heygen__delete_video` | `DELETE /v2/videos/{video_id}` | If no HeyGen MCP tools are available, use direct HTTP API calls with `X-Api-Key: $HEYGEN_API_KEY` header as documented in the reference files. ## Default Workflow **Prefer Video Agent** for most video requests. Always use [prompt-optimizer.md](references/prompt-optimizer.md) guidelines to structure prompts with scenes, timing, and visual styles. **With MCP tools:** 1. Write an optimized prompt using [prompt-optimizer.md](references/prompt-optimizer.md) → [visual-styles.md](references/visual-styles.md) 2. Call `mcp__heygen__generate_video_agent` with prompt and config (duration_sec, orientation, avatar_id) 3. Call `mcp__heygen__get_video` with the returned video_id to poll status and get the download URL **Without MCP tools (direct API):** 1. Write an optimized prompt using [prompt-optimizer.md](references/prompt-optimizer.md) → [visual-styles.md](references/visual-styles.md) 2. `POST /v1/video_agent/generate` — see [video-agent.md](references/video-agent.md) 3. `GET /v2/videos/` — see [video-status.md](references/video-status.md) Only use v2/video/generate when user explicitly needs: - Exact script without AI modification - Specific voice_id selection - Different avatars/backgrounds per scene - Precise per-scene timing control - Programmatic/batch generation with exact specs ## Quick Reference | Task | MCP Tool | Read | |------|----------|------| | Generate video from prompt (easy) | `mcp__heygen__generate_video_agent` | [prompt-optimizer.md](references/prompt-optimizer.md) → [visual-styles.md](references/visual-styles.md) → [video-agent.md](references/video-agent.md) | | Generate video with precise control | — | [video-generation.md](references/video-generation.md), [avatars.md](references/avatars.md), [voices.md](references/voices.md) | | Check video status / get download URL | `mcp__heygen__get_video` | [video-status.md](references/video-status.md) | | Add captions or text overlays | — | [captions.md](references/captions.md), [text-overlays.md](references/text-overlays.md) | | Transparent video for compositing | — | [video-generation.md](references/video-generation.md) (WebM section) | | Use with Remotion | — | [remotion-integration.md](references/remotion-integration.md) | ## Reference Files ### Foundation - [references/authentication.md](references/authentication.md) - API key setup and X-Api-Key header - [references/quota.md](references/quota.md) - Credit system and usage limits - [references/video-status.md](references/video-status.md) - Polling patterns and download URLs - [references/assets.md](references/assets.md) - Uploading images, videos, audio ### Core Video Creation - [references/avatars.md](references/avatars.md) - Listing avatars, styles, avatar_id selection - [references/voices.md](references/voices.md) - Listing voices, locales, speed/pitch - [references/scripts.md](references/scripts.md) - Writing scripts, pauses, pacing - [references/video-generation.md](references/video-generation.md) - POST /v2/video/generate and multi-scene videos - [references/video-agent.md](references/video-agent.md) - One-shot prompt video generation - [references/prompt-optimizer.md](references/prompt-optimizer.md) - Writing effective Video Agent prompts (core workflow + rules) - [references/visual-styles.md](references/visual-styles.md) - 20 named visual styles with full specs - [references/prompt-examples.md](references/prompt-examples.md) - Full production prompt example + ready-to-use templates - [references/dimensions.md](references/dimensions.md) - Resolution and aspect ratios ### Video Customization - [references/backgrounds.md](references/backgrounds.md) - Solid colors, images, video backgrounds - [references/text-overlays.md](references/text-overlays.md) - Adding text with fonts and positioning - [references/captions.md](references/captions.md) - Auto-generated captions and subtitles ### Advanced Features - [references/templates.md](references/templates.md) - Template listing and variable replacement - [references/photo-avatars.md](references/photo-avatars.md) - Creating avatars from photos - [references/webhooks.md](references/webhooks.md) - Webhook endpoints and events ### Integration - [references/remotion-integration.md](references/remotion-integration.md) - Using HeyGen in Remotion compositions ## Dónde encaja - Categoría: [Diseño y UI](https://skillsagentes.com/categorias/diseno-ui.md) — Sistemas de diseño, trabajo con componentes y acabado visual. - Creador: [calesthio](https://skillsagentes.com/creators/calesthio.md) — 0 skills en el directorio - [Todas las skills](https://skillsagentes.com/skills.md) - [Ranking de instalaciones](https://skillsagentes.com/ranking.md) ## Otras skills del mismo repositorio - [Seedance 2 5](https://skillsagentes.com/skills/calesthio/openmontage/seedance-2-5.md): Genera vídeo cinematográfico de 4-30 s con ByteDance Seedance 2.5 por fal.ai, Volcengine Ark, Runway o ComfyUI. Cubre el contrato de prompt 2.5, cortes duros, locks de continuidad y voz. - [Comfyui](https://skillsagentes.com/skills/calesthio/openmontage/comfyui.md): Úsalo al trabajar con workflows de ComfyUI en OpenMontage: comfyui_image/video/music, workflows propios, selección de output_node, modelos que faltan, LoRAs, poca VRAM e importación de workflows de la comunidad. - [Fish Audio Tts](https://skillsagentes.com/skills/calesthio/openmontage/fish-audio-tts.md): Genera narración expresiva y multilingüe con fish.audio (modelos S1 / S2) y reutiliza voces clonadas mediante reference_id. - [Minimax H3](https://skillsagentes.com/skills/calesthio/openmontage/minimax-h3.md): Genera vídeo con MiniMax H3 (Hailuo 3.0) por la API oficial v2, fal.ai, Runway, nodos partner de ComfyUI o pesos abiertos locales. Clips de 4-15s a 2K con animación de primer/último fotograma. - [Gemini Omni](https://skillsagentes.com/skills/calesthio/openmontage/gemini-omni.md): Genera y edita conversacionalmente vídeos cortos con Google Gemini Omni Flash: itera con ediciones en lenguaje natural, clips de 3-10s a 720p con audio y texto en pantalla, e imágenes de referencia por etiquetas. --- Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)