Video Agent (Deprecated)

HeyGen API (Deprecated) 综合评估

核心用法

本技能为 HeyGen AI 数字人视频生成平台的旧版 API 封装，支持通过文字提示生成口播视频、讲解视频和演示内容。主要工具包括：

• mcp__heygen__generate_video_agent：基于提示词一键生成视频
• mcp__heygen__get_video：查询视频状态和下载链接
• mcp__heygen__list_videos / mcp__heygen__delete_video：视频列表管理和删除

显著优点

• 官方 MCP 集成：提供标准化的 MCP 工具，自动处理认证和请求格式
• 丰富的配套文档：包含 20+ 份参考文档，覆盖提示词优化、视觉风格、头像选择、语音配置等
• Video Agent 简化流程：支持自然语言描述即可生成完整视频，降低使用门槛
• 多场景控制：支持精确控制每场景的脚本、头像、背景、时长等参数

潜在缺点与局限性

• ⚠️ 已弃用状态：明确标记为 DEPRECATED，使用 v1/v2 过时端点
• 功能被替代：核心功能已被 create-video 和 avatar-video 两个新技能取代
• 未来移除风险：文档明确说明将在未来版本中删除
• 维护不确定性：作为遗留兼容层，可能缺乏主动更新和安全补丁

适合人群

• 过渡期内需要向后兼容的现有工作流用户
• 需要理解旧版 API 结构以迁移到新技能的开发者
• 已配置 HEYGEN_API_KEY 环境变量的技术用户

常规风险

• API 密钥泄露风险（需妥善保管 HEYGEN_API_KEY）
• 依赖过时端点可能导致突发服务中断
• 配额和计费系统限制（需参考 quota.md）
• 视频生成涉及肖像权和内容合规问题

概述

该 Skill 为 HeyGen AI 数字人视频生成服务的废弃版本文档，涵盖 v1/v2 端点的调用方式。核心功能是指导用户通过 API 创建会说话的数字人视频、讲解视频和演示内容，但已明确标记为 DEPRECATED。

核心用法

废弃端点映射：

• POST /v1/video_agent/generate → 迁移至 create-video Skill (v3 /v3/video-agents)
• GET/DELETE /v2/videos/{id} → 迁移至新 Skill (v3 /v3/videos/{id})
• POST /v2/video/generate → 迁移至 avatar-video Skill (v3 /v3/videos)

遗留工作流程：
1. 使用 prompt-optimizer.md 优化提示词（场景、时长、视觉风格）
2. MCP 工具调用：mcp__heygen__generate_video_agent 生成视频
3. 轮询 mcp__heygen__get_video 获取状态和下载链接
4. 或直接 HTTP 调用（需 X-Api-Key: $HEYGEN_API_KEY）

显著优点

• 纯文档型：无执行代码，安全风险极低
• MCP 工具封装：自动处理认证和请求格式化
• 丰富参考文档：20+ 视觉风格、头像/语音选择指南、提示词优化规则
• 官方文档引用：仅指向 docs.heygen.com 可信域名

局限性与风险

| 问题 | 说明 |

|------|------|

| **端点废弃** | v1/v2 API 随时可能停止服务，导致调用失败 |

| **功能迁移** | 新功能（v3 Video Agent）不在此文档覆盖范围 |

| **维护状态** | 明确标记废弃，未来版本将移除 |

| **配额限制** | 需 HEYGEN_API_KEY，存在信用额度系统 |

适合人群

• 需要维护遗留代码的开发者（临时参考）
• 已了解 v3 API 但需要对比旧接口差异的技术人员
• 不建议新用户直接使用，应优先选择 create-video 或 avatar-video

安全风险

• 无代码注入风险：纯 Markdown，无可执行代码
• API 密钥保护：需 HEYGEN_API_KEY，但未在文档中硬编码
• 隐私合规：无用户数据收集，符合 GDPR/CCPA
• 主要风险：使用废弃端点可能导致服务中断或数据不兼容