avatar-video

Create AI avatar videos with full control over avatars, voices, scripts, and backgrounds using POST /v3/videos . Two creation modes via discriminated union on type : All requests require the X-Api-Key header. Set the HEYGEN_API_KEY environment variable. If HeyGen MCP tools are available ( mcp__heygen__* ), prefer them over direct HTTP API calls — they handle authentication and request formatting automatically. Video generation ( POST /v3/videos ) and avatar/voice listing are done via direct API calls — see reference files below. This skill = precise control (specific avatar, exact script, custom background). create-video = prompt-based ("make me a video about X", AI handles the rest). Read these as needed — they contain endpoint details, request/response schemas, and code examples (curl, TypeScript, Python). Core workflow: Customization: Advanced: - "type": "avatar" + avatar_id — use a HeyGen avatar from the library - "type": "image" + image (AssetInput) — animate any photo via Avatar IV - List avatar looks — GET /v3/avatars/looks → pick a look, note its id (this is the avatar_id ) and default_voice_id .