Create AI avatar videos with precise control over avatars, voices, scripts, scenes, and backgrounds using HeyGen's v2 API.
SkillScore78Maintained
Automatic
◆Marketing & Content pack
Last verified 8/17/2026
What it changes
Passed 17 of 22 test cases with the skill, and 12 of 22 without it.
Without skill57%
With skill78%
Checks it passed that the model alone missed
The generation payload sets test to true
The selected operation is mcp__heygen__delete_video
The selected tool function is mcp__heygen__get_video
and 2 more in the full report
5 fixed13 passed either way5 still failing0 broke
Pass-rate lift
+22 pp
Tokens
+96%
Agent turns
0%
Response time
-31%
Model gemini-3.6-flashMeasured 8/17/2026v118 of 23 cases passed with skill · 22 comparable
Tokens, turns and time describe resource use, not a dollar price.
See it in action
One of 5 test cases the skill fixed. Same model, same prompt, with and without the skill.
1 of 5
Prompt
When testing video generation parameters in the POST request payload without consuming account credits, what exact JSON boolean key should be included?
What was checked, without and with the skill
Checked
Without skill
With skill
The generation payload sets test to true
Missed
Passed
case-13 · gemini-3.6-flash · 8/17/2026 · answers are capped and redacted
What's inside
The instructions your model reads when the skill loads.
SKILL.md103 lines16 files
Avatar Video
Create AI avatar videos with full control over avatars, voices, scripts, scenes, and backgrounds. Build single or multi-scene videos with exact configuration using HeyGen's /v2/video/generate API.
Authentication
All requests require the X-Api-Key header. Set the HEYGEN_API_KEY environment variable.
curl -X GET "https://api.heygen.com/v2/avatars" \
-H "X-Api-Key: $HEYGEN_API_KEY"
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)
Check video status / get URL
mcp__heygen__get_video
GET /v2/videos/{video_id}
List account videos
mcp__heygen__list_videos
GET /v2/videos
Delete a video
mcp__heygen__delete_video
DELETE /v2/videos/{video_id}
Video generation (POST /v2/video/generate) and avatar/voice listing are done via direct API calls — see reference files below.
Default Workflow
List avatars — GET /v2/avatars → pick an avatar, preview it, note avatar_id and default_voice_id. See avatars.md
List voices (if needed) — GET /v2/voices → pick a voice matching the avatar's gender/language. See voices.md
Write the script — Structure scenes with one concept each. See scripts.md
Generate the video — POST /v2/video/generate with avatar, voice, script, and background per scene. See video-generation.md
Poll for completion — GET /v2/videos/{video_id} until status is completed. See video-status.md
Use when working with ComfyUI workflows in Video Production Buddy, including comfyui_image/comfyui_video, custom workflow_json/workflow_path inputs, output_node selection, missing model setup, LoRAs, low-VRAM workflow choices, and community workflow imports.