HeyGen Developers

HeyGen Developers 官方 API 文件，支援 AI 虛擬人影片、翻譯、口型同步與互動式 video-agent 工作流程，提供 API、MCP 與 CLI 介接方式。

HeyGen Developers

HeyGen Developers 是 HeyGen 影片生成平台的官方 API 文件網站。它讓開發者能使用各種工具，透過 `api.heygen.com` 後端建立 AI 虛擬人影片、翻譯影片、加入 lipsync，以及操作互動式 video-agent session。

文件的核心是以 session 為基礎的工作流程：送出提示詞、取得 session ID，接著輪詢取得 video ID 與最終影片 URL，或使用 webhook 處理完成通知。文件也說明了透過 MCP 與 CLI 風格工作流程，供 AI 助手與終端機自動化使用的其他整合方式。

核心功能

提示詞驅動的影片生成

根據提示詞建立 AI 影片 session，並讓代理人處理腳本撰寫、avatar 選擇、場景組合與渲染。

生成與聊天 session 模式

使用單次 `generate` 流程生成影片，或使用 `chat` 模式進行可暫停決策並支援修訂的多輪 session。

影片翻譯

將影片翻譯成 175 種以上語言，並搭配具語境感知的口型同步與性別偵測，專為既有內容配音而設計。

既有素材的 lipsync

使用 lipsync API，為既有影片替換或配上音訊，並同步嘴型動作。

文字轉語音聲音

使用 HeyGen 的文字轉語音聲音，將文字轉為語音音訊，適用於解說、訓練與類似旁白場景。

可設定的 session 輸入

透過 video-agent request body 套用品牌套件、avatar 選擇、可選檔案附件、callback 與畫面方向設定。

常見工作流程

根據提示詞建立影片
團隊可以根據提示詞生成影片初稿，然後透過 API 或 webhook callback 擷取 session 與影片結果。
翻譯並配音內容
在本地化流程中，可將既有影片翻譯成多種語言，同時保持口型同步與新音訊一致。
連接 AI 助手與程式開發代理
開發者可使用 MCP、Skills，或直接 API，在 Claude、Cursor 或其他相容代理中建立 agentic 流程。
製作品牌化影片變體
產品與行銷團隊可使用 avatar、voice、brand kit 與畫面方向設定，透過同一套 API 工作流程產生品牌影片。
自動化可重複的影片任務
營運團隊可在終端機或 CI 環境中，自動化旁白、lipsync 更新與批次影片生成工作。

Pros and Cons

Pros

涵蓋多種建立路徑，包括直接 API 使用、MCP 與 CLI 工作流程。
支援以提示詞驅動的影片生成，且提供單次與多輪代理 session。
在 API 範圍內文件化影片翻譯、lipsync、avatars、voices、assets、webhooks 與品牌資源。
提供清楚的快速上手流程，從建立 API 金鑰到第一次請求與影片擷取。
提供按量付費的入門方案，起價為 $5，文件中也提到企業方案。

Cons

多項功能主要透過參考頁面說明，因此公開首頁在一眼比較不同流程時不太容易。
來源重點在 API 與代理工作流程，而非完整的低程式碼或工作室式介面。
部分定價與方案細節只在文件頁面中摘要說明，因此讀者仍需查閱 API 與定價文件才能了解完整條款。

FAQ

HeyGen 的主要介接方式有哪些？

HeyGen 支援三種介接方式：用於串接 Claude 等 AI 助手的 MCP、用於延伸 Claude Code 與 Cursor 等 AI 程式開發代理的 Skills，以及可進行程式化控制的 Direct API。

要如何驗證請求？

MCP 使用 OAuth，不需要 API 金鑰。Skills 與 Direct API 則使用來自 HeyGen 儀表板的 API 金鑰，並透過 `X-Api-Key` 標頭傳遞。

基本的影片生成工作流程如何運作？

快速開始流程是先建立 API 金鑰，然後向 `https://api.heygen.com/v3/video-agents` 發送 `POST` 請求，接著輪詢 session 與 video 端點，或使用 webhook callback。

文件中記載了哪些定價選項？

按量付費方案起價為 $5。文件也提到 Enterprise 方案，包含自訂擴充性、專屬支援、Digital Twin Creation API、Proofread API，以及折扣費率。

HeyGen 提供哪些 API 資源？

API 文件說明了以 session 為基礎的影片生成、影片翻譯、lipsync、voices、avatars、assets、webhooks 與品牌資源。細節可能因端點而異，而且部分功能仍主要透過參考頁面呈現，而非完整產品頁面。

Quick Facts

類別: 開發者工具
平台: 網頁文件與 API
主要使用者: 開發者與 AI 代理建置者
網域: developers.heygen.com
API 基礎網址: https://api.heygen.com
定價形式: 按量付費起價為 $5