HeyGen Developers icon

HeyGen Developers

HeyGen Developers 官方 API 文档,支持制作 AI 头像视频、视频翻译、口型同步和交互式视频代理会话;适合开发者通过 API、MCP 和 CLI 工作流接入。

HeyGen Developers

HeyGen Developers

HeyGen Developers 是 HeyGen 视频生成平台的官方 API 文档站点。它为开发者提供创建 AI 头像视频、翻译视频、添加口型同步,以及通过 `api.heygen.com` 后端处理交互式视频代理会话的工具。

该文档以基于会话的工作流为核心:发送提示词,获取 session ID,然后轮询 video ID 和最终视频 URL,或使用 webhook 处理完成回调。它还记录了面向 AI 助手和基于终端自动化的 MCP 与 CLI 风格集成路径。

核心能力

基于提示词的视频生成

从提示词创建 AI 视频会话,并让代理处理脚本、头像选择、场景构成和渲染。

生成与聊天会话模式

使用一次性 `generate` 流程生成视频,或使用 `chat` 模式进行多轮会话,在需要决策时可暂停并支持修改。

视频翻译

利用上下文感知的口型同步和性别检测,将视频翻译为 175+ 种语言,专为已有内容配音而设计。

现有素材口型同步

使用 lipsync API 将现有视频中的音频替换或配音,并同步口型动作。

文本转语音音色

使用 HeyGen 的文本转语音音色将文本转换为语音音频,适用于讲解、培训等旁白场景。

可配置的会话输入

通过 video-agent 请求体应用品牌套件、头像选择、可选文件附件、回调和画面方向设置。

常见工作流

  • 从提示词创建视频

    团队可以先根据提示词生成视频初稿,然后通过 API 或 webhook 回调获取会话和视频结果。

  • 翻译并配音内容

    本地化工作流可以将现有视频翻译为多种语言,同时保持口型与新音频同步。

  • 连接 AI 助手和编码代理

    开发者可以使用 MCP、Skills 或直接 API,在 Claude、Cursor 或其他兼容代理中构建代理式工作流。

  • 生成品牌化视频变体

    产品和营销团队可以使用头像、语音、品牌套件和画面方向设置,通过同一 API 工作流制作品牌化视频。

  • 自动化可重复的视频任务

    运营团队可以在终端或 CI 环境中自动化旁白、口型同步更新和批量视频生成任务。

Pros and Cons

Pros

  • 覆盖多种创建路径,包括直接 API 使用、MCP 和 CLI 工作流。
  • 支持基于提示词的视频生成,既有一次性模式,也有多轮代理会话。
  • 在 API 范围内记录了视频翻译、口型同步、头像、语音、素材、webhook 和品牌资源。
  • 提供从创建 API 密钥到首次请求和视频获取的清晰快速入门路径。
  • 提供按量付费入口,起价为 5 美元,文档中还注明了 Enterprise 选项。

Cons

  • 部分能力主要通过参考页面进行说明,因此公开首页在一眼对比工作流时不够直观。
  • 该来源更强调 API 和代理工作流,而不是完整的低代码或工作室式界面。
  • 一些定价和方案细节仅在文档页面中做了摘要,读者仍需查看 API 和定价文档以了解完整条款。

FAQ

与 HeyGen 集成的主要方式有哪些?

HeyGen 支持三种集成路径:使用 MCP 连接 Claude 等 AI 助手、使用 Skills 扩展 Claude Code 和 Cursor 等 AI 编码代理,以及通过 Direct API 进行程序化控制。

如何验证请求身份?

MCP 使用 OAuth,不需要 API 密钥。Skills 和 Direct API 使用从 HeyGen 控制面板获取的 API 密钥,并通过 `X-Api-Key` 请求头传递。

基础的视频生成工作流如何运行?

快速开始流程是先创建 API 密钥,然后向 `https://api.heygen.com/v3/video-agents` 发送 `POST` 请求,接着轮询会话和视频端点,或使用 webhook 回调。

文档中说明了哪些定价选项?

按量付费起价为 5 美元。文档还提到 Enterprise 方案,包含自定义扩展能力、专属支持、Digital Twin Creation API、Proofread API 和折扣费率。

HeyGen 提供哪些类型的 API 资源?

API 文档描述了基于会话的视频生成、视频翻译、口型同步、语音、头像、素材、webhook 和品牌资源。具体内容可能因端点而异,部分能力仍主要通过参考页面呈现,而不是更全面的产品页面。

Quick Facts

类别
开发者工具
平台
网页文档和 API
主要用户
开发者和 AI 代理构建者
域名
developers.heygen.com
API 基础 URL
https://api.heygen.com
定价形式
按量付费起价为 5 美元