用途:该技能面向 HeyGen API,用于生成 AI 数字人说话视频、讲解视频和演示视频。资料明确标注此技能已弃用,文档中的端点为 v1/v2,官方建议改用 create-video(基于提示词的视频生成,Video Agent API,POST /v3/video-agents)或 avatar-video(精确控制数字人、声音、脚本和场景,v3 API,POST /v3/videos)。
主要能力:支持从提示词生成视频、查询视频状态与下载地址、列出账户视频、删除视频;支持数字人、声音、脚本、多场景、背景、文字叠加、字幕、透明视频(WebM)、模板、照片数字人、Webhook 及 Remotion 集成等。
使用方式:若存在 HeyGen MCP 工具(mcp__heygen__*),优先使用,可自动处理认证与请求格式;否则使用直接 HTTP 调用,请求头为 X-Api-Key: $HEYGEN_API_KEY。默认工作流建议优先使用 Video Agent,并参考 prompt-optimizer.md 与 visual-styles.md 编写提示词;调用 mcp__heygen__generate_video_agent 生成,再用 mcp__heygen__get_video 轮询状态并获取下载地址。仅在需要精确脚本、指定 voice_id、逐场景不同数字人/背景或精确时间控制时,才使用直接视频 API(现为 POST /v3/videos)。
适用场景:批量或程序化生成数字人视频、讲解与演示内容,以及需要与 Remotion 组合的场景。
限制:该技能已弃用,将在未来版本移除,仅保留向后兼容;文档中的 v1/v2 端点已过时。资料未提供具体收费、价格、配额数值或效果保证,相关细节暂未提供。