Skip to content

heygen.md

Latest commit

 

History

History
126 lines (97 loc) · 2.93 KB

heygen.md

File metadata and controls

126 lines (97 loc) · 2.93 KB

HeyGen

AI avatar video generation platform. Create talking-head videos from text scripts with realistic lip-sync, expressions, and gestures.

Capabilities

Integration Available Notes
API Yes REST API v2 for video generation, avatars, templates
MCP Yes Official hosted MCP server — no local install needed
CLI - -
SDK Yes Node.js SDK available

Authentication

  • Type: API Key
  • Header: X-Api-Key: {api_key}
  • Get key: Settings > API in HeyGen dashboard

MCP Server Setup

HeyGen provides a hosted remote MCP server. No local installation required.

Claude Code / Claude Desktop

Add to your MCP config:

{
  "mcpServers": {
    "heygen": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.heygen.com/mcp"]
    }
  }
}

On first use, authenticates via browser OAuth. The MCP server exposes tools for:

  • Creating videos from scripts
  • Listing and selecting avatars
  • Managing templates
  • Checking video status

API Quick Start

Create a Video

curl -X POST https://api.heygen.com/v2/video/generate \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video_inputs": [{
      "character": {
        "type": "avatar",
        "avatar_id": "AVATAR_ID",
        "avatar_style": "normal"
      },
      "voice": {
        "type": "text",
        "input_text": "Your script goes here.",
        "voice_id": "VOICE_ID"
      }
    }],
    "dimension": {
      "width": 1920,
      "height": 1080
    }
  }'

List Avatars

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

Check Video Status

curl https://api.heygen.com/v1/video_status.get?video_id=VIDEO_ID \
  -H "X-Api-Key: YOUR_API_KEY"

Common Marketing Use Cases

Use Case Approach
Product explainer Script from features → avatar presents
Feature announcement Template with avatar + screen recording
Multilingual content Same script, different language/voice
Personalized outreach Dynamic variables (name, company) in script
Weekly updates Recurring template, swap script text

Custom Avatars

Upload a 2-5 minute video of yourself speaking to create a digital twin:

  • Looks and sounds like you
  • Generates unlimited videos from text scripts
  • Available on Creator plan and above

Pricing

Plan Videos/mo Max Duration
Free 3 3 min
Creator Unlimited 5 min
Business Unlimited 20 min
Enterprise Unlimited Custom

Check heygen.com/pricing for current prices — they change frequently.

Rate Limits

  • Free: 3 videos/month
  • Paid: Based on plan tier, concurrent generation limits apply
  • API rate limits: Check response headers for X-RateLimit-*

Relevant Skills

  • video
  • social
  • ad-creative
  • sales-enablement