核心用法
avatar-video 是基于 HeyGen v2 API 的专业级 AI 数字人视频生成技能，提供从虚拟形象选择到多场景视频合成的全流程精确控制。核心工作流包括：浏览并预览数字人形象（avatars）、选择匹配的声音（voices）、撰写结构化脚本（scripts）、配置单场景或多场景视频生成，最后轮询获取成品视频 URL。
该技能支持高度定制化：可为每个场景设置独立背景（纯色/图片/视频）、添加文本叠加层、生成透明背景 WebM 格式便于后期合成、使用照片生成会说话的虚拟人，以及与 Remotion 等视频编辑框架集成实现批量生成。
显著优点
1. 官方 API 直接对接：HeyGen 是 AI 数字人领域头部平台，技术成熟，生成质量稳定
2. 精确控制能力：区别于全自动视频生成，支持逐场景配置 avatar、voice、background、script
3. 多场景叙事：支持复杂视频结构，不同场景切换不同背景和内容
4. 专业输出格式：支持透明 WebM、字幕生成、文本叠加等后期友好格式
5. MCP 工具封装：优先使用 mcp__heygen__* 工具，自动处理认证和请求格式化
潜在缺点与局限性
- 生成耗时较长：视频生成通常需 5-15 分钟，需异步轮询
- 配额与成本：依赖 HeyGen 积分系统，大规模批量生成成本较高
- 测试模式限制：开发测试时输出带水印
- 环境依赖：必须配置
HEYGEN_API_KEY，无免费试用层 - 学习曲线：相比全自动视频生成，需要理解 avatar/voice/scene 等概念映射
适合人群
- 品牌营销团队：需要统一虚拟形象、品牌一致的规模化视频生产
- 内容创作者：需要精确控制台词和呈现的专业播客/教程制作者
- 开发者/技术团队：需集成 Remotion、实现批量生成或 webhook 自动化的工程场景
- 电商与 SaaS：产品演示视频、个性化客户沟通视频的自动化生产
常规风险
| 风险类型 | 说明 |
|---------|------|
| API 密钥泄露 | `HEYGEN_API_KEY` 需妥善保管，避免硬编码 |
| 配额超额 | 建议实现额度监控，避免意外消耗 |
| 生成失败处理 | 需完善轮询超时和错误重试机制 |
| 版权合规 | 使用第三方 avatar/voice 素材需确认授权范围 |
与 Create Video 技能的区别
| 场景 | 推荐技能 |
|-----|---------|
| "帮我做个关于X的视频"（全自动） | create-video |
| "让Y形象说Z台词，背景用蓝色"（精确控制） | **avatar-video** |
| 透明背景 WebM、多场景切换、特定语音 | **avatar-video** |