heygen-avatar-lite

Create AI digital human videos with HeyGen API. Free starter guide.

7 stars

Best use case

heygen-avatar-lite is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Create AI digital human videos with HeyGen API. Free starter guide.

Teams using heygen-avatar-lite should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

You only need a quick one-off answer and do not need a reusable workflow.
You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/heygen-avatar-lite/SKILL.md --create-dirs "https://raw.githubusercontent.com/Demerzels-lab/elsamultiskillagent/main/public/skills/daaab/heygen-avatar-lite/SKILL.md"

Manual Installation

Download SKILL.md from GitHub
Place it in .claude/skills/heygen-avatar-lite/SKILL.md inside your project
Restart your AI agent — it will auto-discover the skill

How heygen-avatar-lite Compares

Feature / Agent	heygen-avatar-lite	Standard Approach
Platform Support	Not specified	Limited / Varies
Context Awareness	High	Baseline
Installation Complexity	Unknown	N/A

Frequently Asked Questions

What does this skill do?

Create AI digital human videos with HeyGen API. Free starter guide.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# 🎬 HeyGen AI Avatar Video (Lite)

Create professional AI-generated videos with your own digital human avatar!

## 🎯 What You'll Build

- Generate videos with AI avatars speaking any text
- Support for multiple languages
- Portrait (9:16) and Landscape (16:9) formats
- Custom voice cloning integration

## 📋 Prerequisites

1. **HeyGen Account** (Creator plan or above)
   - Sign up: https://heygen.com
   - Get API key from Settings → API

2. **Custom Avatar** (optional)
   - Upload training video to create your digital twin
   - Or use HeyGen's stock avatars

## 🏗️ Architecture

```
┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│   Your App  │────▶│  HeyGen API │────▶│   Video     │
│  (trigger)  │     │  (generate) │     │   Output    │
└─────────────┘     └─────────────┘     └─────────────┘
        │                  │
        ▼                  ▼
   ┌─────────┐      ┌─────────────┐
   │  Text   │      │   Avatar +  │
   │  Input  │      │   Voice     │
   └─────────┘      └─────────────┘
```

## 🚀 Quick Start

### Step 1: Get Your API Key

```bash
HEYGEN_API_KEY="your_api_key_here"
```

### Step 2: List Available Avatars

```bash
curl -X GET "https://api.heygen.com/v2/avatars" \
  -H "X-Api-Key: $HEYGEN_API_KEY" | jq '.data.avatars[:5]'
```

### Step 3: List Available Voices

```bash
curl -X GET "https://api.heygen.com/v2/voices" \
  -H "X-Api-Key: $HEYGEN_API_KEY" | jq '.data.voices[:5]'
```

### Step 4: Generate a Video

```bash
curl -X POST "https://api.heygen.com/v2/video/generate" \
  -H "X-Api-Key: $HEYGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video_inputs": [{
      "character": {
        "type": "avatar",
        "avatar_id": "YOUR_AVATAR_ID",
        "avatar_style": "normal"
      },
      "voice": {
        "type": "text",
        "input_text": "Hello! This is my AI avatar speaking.",
        "voice_id": "YOUR_VOICE_ID"
      }
    }],
    "dimension": {
      "width": 1280,
      "height": 720
    }
  }'
```

### Step 5: Check Video Status

```bash
VIDEO_ID="your_video_id"
curl -X GET "https://api.heygen.com/v1/video_status.get?video_id=$VIDEO_ID" \
  -H "X-Api-Key: $HEYGEN_API_KEY"
```

## 📐 Video Dimensions

| Format | Dimensions | Use Case |
|--------|------------|----------|
| Landscape | 1280x720 | YouTube, Website |
| Portrait | 720x1280 | TikTok, Reels, Shorts |
| Square | 1080x1080 | Instagram |

## 💰 Cost Estimate

| Plan | Price | Credits |
|------|-------|---------|
| Creator | $29/month | 15 min/month |
| Business | $89/month | 30 min/month |
| Per-minute overage | ~$1-2/min | - |

## ⚠️ Limitations of Lite Version

- Basic API guide only
- No automation scripts
- No error handling
- No subtitle integration
- Community support only

## 🚀 Want More?

**Premium Version** includes:
- ✅ Complete Python generation script
- ✅ Automatic video download
- ✅ Portrait + Landscape presets
- ✅ Integration with ZapCap subtitles
- ✅ Batch video generation
- ✅ LINE/Telegram delivery integration
- ✅ Priority support

Get it on **Virtuals ACP**: Find @LittleLobster

---

Made with 🦞 by LittleLobster