核心用法
HeyGen 是一项 AI 数字人视频生成 API 服务，通过文本提示或精确场景控制创建 talking-head 解说视频。目前该 skill 已被标记为 DEPRECATED（弃用），官方推荐迁移至两个更聚焦的替代方案：
- `create-video` — 基于提示词的一站式视频生成（Video Agent API）
- `avatar-video` — 精确控制数字人、语音、场景和时长的 v2 API
工作流概览
推荐路径（Video Agent）：
1. 使用 prompt-optimizer.md 优化提示词结构
2. 调用 mcp__heygen__generate_video_agent 生成视频
3. 通过 mcp__heygen__get_video 轮询状态获取下载链接
精确控制路径（v2 API）：
- 仅在需要固定脚本、指定 voice_id、多场景切换、精确时长控制时使用
主要功能
- AI 数字人（Avatar）视频合成
- 多语言语音克隆与合成
- 场景化视频生成（提示词驱动）
- 字幕、文本叠加、透明背景（WebM）
- 模板变量替换与批量生成
显著优点
- 官方 API 集成：直接对接 HeyGen 官方服务，非第三方封装
- MCP 工具支持：提供标准化 MCP 工具，自动处理认证和请求格式
- 双模式灵活：既有简单提示词模式，也有精确参数控制模式
- 丰富文档：包含 20+ 个参考文件覆盖从认证到高级集成
潜在缺点与局限性
- 已弃用状态：该 skill 将在未来版本移除，存在迁移成本
- API Key 依赖：需配置 HEYGEN_API_KEY 环境变量
- 配额消耗：基于积分制（Credit system），需关注用量限制
- 异步生成：视频生成需轮询状态，非实时返回
- 仅支持云端：无法本地运行，依赖 HeyGen 服务可用性
适合人群
- 内容创作者批量生成解说视频
- 营销团队制作多语言产品介绍
- 开发者集成数字人视频到应用工作流
- 需要程序化视频生成的自动化场景
常规风险
- 服务迁移风险：当前 skill 已弃用，需规划向新 skill 的迁移
- API 配额超额：未监控用量可能导致服务中断
- 内容合规性：AI 生成内容需遵守平台使用政策和版权规范
- 生成失败处理：需实现完善的错误处理和重试机制