HeyGen API (已弃用)

此技能已弃用。请改用以下聚焦技能：

• create-video— 根据文本提示生成视频（Video Agent API）
• avatar-video— 使用特定头像、声音、脚本和场景构建视频（v2 API）

此技能为向后兼容而保留，但将在未来版本中移除。

用于生成会说话的头像视频、解说视频和演示文稿的AI头像视频创作API。

工具选择

如果HeyGen MCP工具可用（mcp__heygen__*），优先使用它们而非直接进行HTTP API调用——它们会自动处理身份验证和请求格式化。

如果没有可用的HeyGen MCP工具，请使用直接的HTTP API调用，并附带X-Api-Key: $HEYGEN_API_KEY请求头，如参考文件中所述。

默认工作流程

对于大多数视频请求，优先使用视频代理。始终使用prompt-optimizer.md指南来构建提示，包括场景、时间和视觉风格。

使用MCP工具时：

1. 使用prompt-optimizer.md编写优化后的提示。visual-styles.md
2. 调用mcp__heygen__generate_video_agent并提供提示词和配置参数（duration_sec, orientation, avatar_id）
3. 调用mcp__heygen__get_video并传入返回的 video_id 来轮询状态并获取下载链接

若不使用 MCP 工具（直接调用 API）：

1. 使用prompt-optimizer.md撰写优化的提示词→
2. visual-styles.mdPOST /v1/video_agent/generate— 参见
3. video-agent.mdGET /v2/videos/<id>— 参见

video-status.md

• 仅当用户明确需要时，才使用 v2/video/generate：
• 无需 AI 修改的精确脚本
• 特定的 voice_id 选择
• 精确的逐场景时间控制
• 基于精确规格的程序化/批量生成

快速参考

参考文件

基础

• references/认证.md- API 密钥设置和 X-Api-Key 请求头
• references/配额.md- 点数系统和用量限制
• references/视频状态.md- 轮询模式和下载链接
• references/资产.md- 上传图片、视频、音频

核心视频创建

• references/虚拟形象.md- 列出虚拟形象、风格、选择 avatar_id
• references/voices.md- 列出语音、语言区域、语速/音调
• references/scripts.md- 撰写脚本、停顿、节奏控制
• references/video-generation.md- POST /v2/video/generate 与多场景视频
• references/video-agent.md- 单次提示视频生成
• references/prompt-optimizer.md- 撰写有效的视频代理提示（核心工作流程 + 规则）
• references/visual-styles.md- 20种具名的视觉风格及其完整规格
• references/prompt-examples.md- 完整生产提示示例 + 即用型模板
• references/dimensions.md- 分辨率与宽高比

视频定制

• references/backgrounds.md- 纯色、图像、视频背景
• references/text-overlays.md- 添加带有字体和定位的文本
• references/captions.md- 自动生成的字幕和说明文字

高级功能

• references/templates.md- 模板列表和变量替换
• references/photo-avatars.md- 从照片创建头像
• references/webhooks.md- Webhook端点和事件

集成

• references/remotion-integration.md- 在Remotion合成中使用HeyGen