heygen
SKILL.md
HeyGen API
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 /v1/video_status.get |
| List account videos | mcp__heygen__list_videos |
GET /v1/video.list |
| Delete a video | mcp__heygen__delete_video |
DELETE /v1/video.delete |
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.