Video Agent (Deprecated)

核心用法

HeyGen 技能提供 AI 数字人视频生成能力，包含两种主要工作模式：

1. Video Agent 模式（推荐）

• 通过自然语言提示词生成视频
• 使用 mcp__heygen__generate_video_agent 工具
• 需配合 prompt-optimizer.md 优化提示词结构
• 支持场景描述、时长控制、视觉风格指定

2. v2 API 模式（精确控制）

• 通过 POST /v2/video/generate 精确控制每个场景
• 可指定具体 avatar_id、voice_id、脚本内容
• 适合批量生成、程序化工作流

通用工作流
1. 准备提示词或精确脚本
2. 调用生成工具/接口获取 video_id
3. 轮询 mcp__heygen__get_video 或直接调用 GET /v2/videos/{id} 获取状态和下载链接

显著优点

• MCP 工具集成：自动处理认证和请求格式化，降低使用门槛
• 双模式灵活：提示词模式适合快速创作，精确控制满足专业需求
• 丰富配套文档：20+ 参考文件覆盖视觉风格、头像、语音、字幕等全链路
• 透明视频支持：可生成 WebM 格式用于后期合成

潜在缺点与局限性

• 已弃用状态：官方明确标记 [DEPRECATED]，建议迁移至 create-video 和 avatar-video
• 异步生成：视频生成需轮询等待，非即时返回
• 额度限制：依赖信用额度系统，需注意配额消耗
• API Key 依赖：必须配置 HEYGEN_API_KEY，无免费体验层

适合人群

• 需要批量生成数字人营销视频的内容创作者
• 集成 AI 视频能力至产品的工作流开发者
• 有一定技术基础、能接受异步生成模式的团队

常规风险

• 服务终止风险：弃用技能可能在将来版本移除，需提前迁移
• 成本不可控：视频生成按秒计费，长视频或高频调用易超预算
• 内容合规：AI 生成内容可能涉及肖像权、版权问题，需自行审核
• 数据隐私：上传的照片、脚本等素材传输至第三方服务商

核心用法

本 Skill 提供 HeyGen API 的 AI 数字人视频生成功能，支持两种主要工作流：

1. Video Agent 模式（推荐）：通过自然语言提示词生成视频，使用 mcp__heygen__generate_video_agent 工具，适合快速创建 explainer、演示文稿等 talking-head 视频
2. v2 API 精确控制模式：通过 POST /v2/video/generate 实现精细控制，包括特定 avatar、voice、脚本和分场景设置

标准流程：撰写优化提示词（参考 prompt-optimizer.md）→ 调用生成工具 → 轮询获取视频状态与下载链接。

显著优点

• MCP 工具集成：优先使用封装好的 MCP 工具，自动处理认证和请求格式，降低使用门槛
• 丰富的视觉风格：内置 20+ 命名视觉风格（见 visual-styles.md），支持多种场景需求
• 完整的参考文档体系：涵盖 avatars、voices、scripts、backgrounds、captions 等全链路配置指南
• 透明背景支持：可生成 WebM 透明通道视频，便于后期合成

潜在缺点与局限性

• 已弃用状态：官方明确标记 DEPRECATED，将在未来版本移除
• 功能分散：当前 Skill 合并了两种不同工作流，新用户容易混淆
• 依赖外部 API：所有视频生成依赖 HeyGen 云服务，需有效订阅和可用额度
• 无实时预览：生成过程需异步轮询，无法实时调整
• T3 可信度：由个人开发者维护，非官方 Skill

适合人群

• 需快速生成 AI 数字人视频的内容创作者
• 熟悉 MCP 工具链的技术用户
• 已有 HeyGen 订阅且希望通过 AI 助手自动化视频工作流的用户

常规风险

• API 密钥泄露风险：需妥善保管 HEYGEN_API_KEY，建议使用环境变量
• 服务可用性依赖：HeyGen 服务中断将直接影响功能
• 额度消耗：视频生成消耗 API Credits，需监控用量
• 迁移成本：当前 Skill 即将废弃，新项目建议直接使用 create-video 或 avatar-video