HeyGen 是一个 AI 数字人视频创作 API 技能,主要面向:生成口播视频、讲解视频和演示视频。当前该技能被明确标记为弃用(DEPRECATED),保留仅为向后兼容,未来版本将移除。官方建议改用两个聚焦技能:create-video 用于根据文本提示词生成视频(Video Agent API),avatar-video 用于精确控制数字人、声音、脚本和场景(v2 API)。
主要能力:根据提示词生成视频;查询视频状态并获取下载 URL;列出账户视频;删除视频;使用 v2 接口进行精确控制生成,涉及脚本指定、voice_id 选择、按场景配置不同数字人与背景、逐场景时间控制、程序化或批量生成;为视频添加字幕与文字叠加;生成可用于合成的透明视频(WebM);与 Remotion 集成。
使用方式:若环境中提供 HeyGen MCP 工具(mcp__heygen__*),优先使用;生成视频调用 mcp__heygen__generate_video_agent,查询状态调用 mcp__heygen__get_video,列出视频调用 mcp__heygen__list_videos,删除视频调用 mcp__heygen__delete_video。若无 MCP 工具,则直接调用 HTTP API:生成 POST /v1/video_agent/generate,查询 GET /v2/videos/{video_id},列表 GET /v2/videos,删除 DELETE /v2/videos/{video_id};请求头使用 X-Api-Key: $HEYGEN_API_KEY。默认工作流建议优先使用 Video Agent,并按 prompt-optimizer.md 与 visual-styles.md 的规范组织包含场景、时间与视觉风格的提示词,随后轮询状态获取下载链接。仅在需要精确脚本、指定 voice_id、逐场景不同数字人/背景或精确时间控制时,才使用 v2/video/generate。
适用场景:口播类与讲解类视频、演示视频、批量或程序化视频生成、需要透明背景合成的视频,以及在 Remotion 合成中使用 HeyGen。
限制:该技能已弃用;具体调用依赖 HeyGen API 凭据(HEYGEN_API_KEY);未提供定价、额度数值、平台支持范围或效果指标,暂未提供;使用前应遵循官方替代技能建议。