Video Agent (Deprecated) — Video 代理 (Deprecated)

HeyGen API (Deprecated)

This 技能 is deprecated. Use the focused 技能s instead:

创建-video — 生成 videos from a text prompt (Video 代理 API, POST /v3/video-代理s) avatar-video — Build videos with specific avatars, voices, scripts, and scenes (v3 API, POST /v3/videos)

警告: The 端点s documented below are v1/v2 and deprecated. The replacement 技能s above use the current v3 API.

This 技能 remAIns for backward compatibility but will be 移除d in a future release.

AI avatar video creation API for generating talking-head videos, explAIners, and presentations.

工具 Selection

If HeyGen MCP 工具s are avAIlable (mcp__heygen__*), prefer them over direct HTTP API calls — they handle authentication and 请求 格式化ting automatically.

Task MCP 工具 Deprecated 端点 v3 Replacement 生成 video from prompt mcp__heygen__生成_video_代理 POST /v1/video_代理/生成 POST /v3/video-代理s 检查 video 状态 / 获取 URL mcp__heygen__获取_video 获取 /v2/videos/{video_id} 获取 /v3/videos/{video_id} 列出 account videos mcp__heygen__列出_videos 获取 /v2/videos 获取 /v3/videos 删除 a video mcp__heygen__删除_video 删除 /v2/videos/{video_id} 删除 /v3/videos/{video_id}

If no HeyGen MCP 工具s are avAIlable, use direct HTTP API calls with X-API-Key: $HEYGEN_API_KEY header as documented in the reference files.

Default 工作流

Prefer Video 代理 for most video 请求s. Always use prompt-优化器.md 图形界面delines to structure prompts with scenes, timing, and visual styles.

With MCP 工具s:

Write an 优化d prompt using prompt-优化器.md → visual-styles.md Call mcp__heygen__生成_video_代理 with prompt and config (duration_sec, orientation, avatar_id) Call mcp__heygen__获取_video with the returned video_id to poll 状态 and 获取 the 下载 URL

Without MCP 工具s (direct API) — use v3 端点s from 创建-video or avatar-video 技能s:

Write an 优化d prompt using prompt-优化器.md → visual-styles.md POST /v3/video-代理s (replaces /v1/video_代理/生成) — see 创建-video 技能 获取 /v3/videos/ (replaces /v2/videos/) — see 创建-video 技能

Only use the direct video API (now POST /v3/videos, formerly v2/video/生成) when user explicitly needs:

Exact script without AI modification Specific voice_id selection Different avatars/backgrounds per scene Precise per-scene timing control Programmatic/batch generation with exact specs Quick Reference Task MCP 工具 Read 生成 video from prompt (easy) mcp__heygen__生成_video_代理 prompt-优化器.md → visual-styles.md → video-代理.md 生成 video with precise control — video-generation.md, avatars.md, voices.md 检查 video 状态 / 获取 下载 URL mcp__heygen__获取_video video-状态.md 添加 captions or text overlays — captions.md, text-overlays.md Transparent video for compositing — video-generation.md (网页M section) Use with Remotion — remotion-integration.md Reference Files Foundation references/authentication.md - API key 设置up and X-API-Key header references/quota.md - Credit 系统 and usage limits references/video-状态.md - Polling patterns and 下载 URLs references/as设置s.md - 上传ing images, videos, audio Core Video Creation references/avatars.md - 列出ing avatars, styles, avatar_id selection references/voices.md - 列出ing voices, locales, speed/pitch references/scripts.md - Writing scripts, 暂停s, pacing references/video-generation.md - Video generation and multi-scene videos (uses deprecated v2 端点 — see avatar-video 技能 for v3) references/video-代理.md - One-shot prompt video generation references/prompt-优化器.md - Writing effective Video 代理 prompts (core 工作流 + rules) references/visual-styles.md - 20 named visual styles with full specs references/prompt-examples.md - Full production prompt example + ready-to-use templates references/dimensions.md - Resolution and aspect ratios Video Customization references/backgrounds.md - Solid colors, images, video backgrounds references/text-overlays.md - 添加ing text with fonts and positioning references/captions.md - Auto-生成d captions and subtitles Advanced Features references/templates.md - Template 列出ing and variable replacement references/photo-avatars.md - Creating avatars from photos references/网页hooks.md - 网页hook 端点s and 事件 Integration references/remotion-integration.md - Using HeyGen in Remotion compositions