heygen

Generates AI avatar videos through the HeyGen API using prompts, avatars, voices, and scenes.

Updated Jul 16, 2026
One-click install
npx skills add https://github.com/X-manist/Cohmira --skill heygen-x-manist
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: heygen
Source: https://github.com/X-manist/Cohmira/tree/main/src/builtin-plugins/openmontage/.agents/skills/heygen
Command: npx skills add https://github.com/X-manist/Cohmira --skill heygen-x-manist

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Creating talking-head videos, explainers, and presentations traditionally requires cameras, actors, and editing time. This Skill connects to the HeyGen API so you can generate AI avatar videos programmatically, from one-shot prompt-based generation to precise multi-scene productions with specific avatars, voices, backgrounds, and captions. ## Core Features & Use Cases - Prompt-Based Video Generation: Use the Video Agent API to turn a structured text prompt into a complete video, with guidance on writing production-quality prompts using named visual styles and scene-by-scene breakdowns. - Precise Avatar Control: Build videos with the v2 API by selecting specific avatars, voices, scripts, backgrounds, text overlays, and per-scene timing. - Photo Avatars & Assets: Upload images to create talking-photo avatars, generate AI photo avatars from text descriptions, and manage custom media assets. - Use Case: A marketing team needs a 90-second monthly metrics report video. The Skill guides prompt writing with the Swiss Pulse visual style, generates the video via the Video Agent endpoint, then polls the status endpoint to retrieve the download URL. ## Quick Start Ask the AI to generate a HeyGen video from a short brief, for example: create a 60-second landscape video with a professional avatar announcing our product launch. Note: This Skill is marked deprecated in favor of the focused create-video and avatar-video skills, but remains functional for backward compatibility.

Frequently Asked Questions about heygen

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a video with the HeyGen API?

Call POST /v1/video_agent/generate with an optimized prompt for one-shot generation, or POST /v2/video/generate with explicit video_inputs defining avatar, voice, and background per scene. Poll GET /v2/videos/{video_id} to retrieve the download URL when processing completes.

How do I create a talking photo avatar in HeyGen?

Upload an image to upload.heygen.com/v1/asset to get an image_key, then POST it to /v2/photo_avatar/avatar_group/create. Wait for status to become completed, then use the returned id as talking_photo_id in video generation.

Should I use HeyGen MCP tools or direct API calls?

Prefer MCP tools like mcp__heygen__generate_video_agent when available, since they handle authentication and request formatting automatically. Fall back to direct HTTP calls with the X-Api-Key header when MCP tools are not configured.

What video dimensions and formats does HeyGen support?

HeyGen supports 720p and 1080p in landscape (16:9), portrait (9:16), and square (1:1) aspect ratios, with custom dimensions between 128px and 4096px per side. Output is MP4, with WebM available for transparent compositing workflows.

Why does my HeyGen Video Agent prompt produce poor results?

Common causes include layout-coordinate language instead of motion verbs, B-roll scenes under 5 seconds, missing critical on-screen text lists, and content written as a list rather than a narrative. Follow the prompt-optimizer guidelines with layered scenes and named visual styles.

What are the limitations of HeyGen photo avatars?

Photo avatars require clear, front-facing portraits of at least 512x512px under 10MB. Side-profile photos have limited support, full-body photos may not animate properly, and output quality depends heavily on input photo lighting and sharpness.