核心功能与定位
HeyGen API 是一项 AI 数字人视频生成服务，专注于创建对口型讲解视频（talking-head videos）、产品演示和营销内容。该技能当前已被标记为 DEPRECATED，官方建议迁移至两个更专注的替代技能：
create-video：基于提示词的 Video Agent 视频生成avatar-video：精确控制数字人、声音、场景和脚本的专业级视频制作
核心用法
该技能支持两种主要工作流：
Video Agent（推荐默认）：
- 通过自然语言提示词一次性生成完整视频
- 需配合
prompt-optimizer.md优化提示结构（场景、时长、视觉风格） - MCP 工具：
mcp__heygen__generate_video_agent
v2 API（精确控制）：
- 多场景精细编排，逐场景指定数字人、背景、语音
- 适用于需要严格脚本控制、批量生成或特定语音 ID 的场景
- 直接调用
POST /v2/video/generate
显著优点
- MCP 集成：优先使用 MCP 工具自动处理认证和请求格式化，降低开发门槛
- 丰富参考文档：20+ 结构化参考文件涵盖提示优化、视觉风格、字幕、透明背景等
- 多层级控制：从一句话提示到逐帧场景编排，覆盖不同技术深度需求
- 生态整合：支持与 Remotion 等专业视频工具链集成
局限性与风险
- 已弃用状态：核心缺陷在于该技能已被官方弃用，未来版本将移除，存在迁移成本
- 配额与计费：基于信用点（credit）的计费系统，需关注
quota.md中的额度限制 - 异步轮询：视频生成需轮询状态获取最终 URL，无实时推送（webhook 需额外配置）
- 提示词依赖：Video Agent 效果高度依赖提示词质量，需学习特定优化规范
适合人群
- 需要将现有 HeyGen 集成迁移到新技能的开发者
- 维护遗留系统的工程团队（需制定迁移计划）
- 不建议新用户直接使用，应选择
create-video或avatar-video
常规风险提示
- API 密钥（
HEYGEN_API_KEY）需妥善保管，避免硬编码提交至版本控制 - 注意视频内容合规性，AI 生成人物可能涉及肖像权与深度伪造（deepfake）相关法规
- 弃用技能可能随时停止维护，建议 30-60 天内完成迁移评估