Video Agent (Deprecated)

HeyGen 是一款领先的 AI 数字人视频生成平台 API，支持通过文字提示或精确参数控制创建虚拟主播讲解、产品演示、教育培训等视频内容。

核心用法

该技能提供两种主要工作流：

• Video Agent 模式（推荐）：通过自然语言提示自动生成完整视频，系统自动处理场景、转场、头像和语音
• v2 API 精确控制：手动指定 avatar_id、voice_id、脚本、背景等参数，适合批量生产和品牌一致性要求高的场景

支持 MCP 工具自动处理认证（mcp__heygen__*），无需手动管理 API Key 和请求格式。

显著优点

1. 真实感强：数字人唇形同步、表情自然度行业领先
2. 多语言支持：丰富的 avatar 和 voice 库，覆盖主流语种
3. MCP 集成：工具自动处理认证，降低开发门槛
4. 灵活输出：支持透明背景 WebM、多种分辨率（横屏/竖屏）

潜在缺点与局限性

1. 已弃用状态：该技能标记为 DEPRECATED，未来版本将移除
2. 成本较高：按视频时长计费，批量生成成本累积快
3. 生成延迟：视频渲染需异步轮询（通常 30 秒至数分钟）
4. 创意受限：提示词工程要求高，复杂场景需多次迭代

适合人群

• 营销团队快速制作产品讲解视频
• 教育机构生成多语言课程内容
• 内容创作者批量生产短视频素材

常规风险

• API Key 泄露导致额度被盗刷
• 生成内容需审核，存在合规风险
• 依赖外部服务，网络波动影响可用性

核心用法

HeyGen 是一项基于 AI 的数字人视频生成服务，该 Skill 提供其 API 的完整调用指南。主要功能包括：

• Video Agent 工作流（推荐）：通过自然语言描述生成完整视频，AI 自动选择虚拟形象、场景、语音和脚本
• v2 API 精确控制：针对需要特定脚本、指定声音、多场景切换或批量生成的专业场景
• 视频管理：查询生成状态、获取下载链接、列出现有视频、删除视频

使用流程：编写优化提示词 → 调用生成接口 → 轮询状态获取下载 URL。支持横竖屏、自定义时长、透明背景等参数。

显著优点

• 零代码集成：纯文档型 Skill，通过 MCP 工具自动处理认证和请求格式
• 生产级文档：包含 20+ 份详细参考文档，涵盖提示词优化、视觉风格、虚拟形象选择等
• 安全架构：仅调用官方 HeyGen API，TLS 1.3 加密，无敏感信息硬编码
• 合规保障：通过 GDPR/CCPA 隐私合规检查，无数据外泄风险
• 灵活工作流：从简单一句话生成到多场景精确控制，覆盖不同复杂度需求

潜在局限

• 已弃用状态：官方标记为 [DEPRECATED]，未来版本将移除，需迁移至 create-video 或 avatar-video
• 付费服务：需 HeyGen API Key 和账户积分，存在调用成本
• 异步生成：视频生成非即时完成，需轮询等待（通常数分钟）
• 中文支持有限：虚拟形象和语音库以英文为主，中文场景选择较少
• 生成可控性：AI 自动编排可能与预期存在偏差，精确控制需学习 v2 API

适合人群

• 营销团队：快速批量生成产品讲解、广告素材
• 教育机构：制作标准化课程视频、多语言版本
• 内容创作者：将文本内容转化为虚拟主播视频
• 开发者：需要程序化视频生成的自动化工作流
• 企业培训：统一品牌形象的内部培训视频制作

常规风险

• API 密钥泄露：HEYGEN_API_KEY 需通过环境变量配置，避免硬编码提交至版本控制
• 配额消耗：视频生成消耗积分，需监控用量防止意外超额
• 版权合规：商用需注意虚拟形象授权和生成内容的知识产权
• 服务依赖：HeyGen 服务可用性直接影响业务，建议设计降级方案
• 内容审核：AI 生成内容可能需人工审核，避免品牌风险

---

注：该 Skill 已被官方弃用，建议新项目直接使用 `create-video` 或 `avatar-video`。