HeyGen Developers

HeyGen Developersの公式APIドキュメント。AIアバター動画、翻訳、lipsync、インタラクティブ動画エージェントの開発に対応。API、MCP、CLIで利用可能。

HeyGen Developers

HeyGen Developers は、HeyGen の動画生成プラットフォーム向けの公式 API ドキュメントサイトです。開発者は、AI アバター動画の作成、動画の翻訳、lipsync の追加、`api.heygen.com` バックエンドを介したインタラクティブな動画エージェントセッションの操作に使えるツールへアクセスできます。

このドキュメントの中心はセッションベースのワークフローです。プロンプトを送信し、session ID を受け取り、その後 video ID と最終的な video URL をポーリングするか、完了処理には webhooks を使用します。また、AI アシスタントやターミナルベースの自動化向けに、MCP と CLI スタイルのワークフローによる代替の統合方法も説明しています。

コア機能

プロンプト駆動の動画生成

プロンプトから AI 動画セッションを作成し、エージェントにスクリプト作成、アバター選択、シーン構成、レンダリングを任せられます。

generate と chat のセッションモード

1 回で完結する `generate` フローで動画を生成するか、意思決定のために一時停止でき、修正も可能な複数ターンのセッションには `chat` モードを使用できます。

動画翻訳

コンテキストを考慮したリップシンクと性別検出により、175 以上の言語へ動画を翻訳でき、既存コンテンツの吹き替えに適しています。

既存映像向けの lipsync

lipsync API を使用して、既存動画の音声を同期した口の動きとともに置き換えたり吹き替えたりできます。

テキスト読み上げ音声

HeyGen のテキスト読み上げ音声を使用してテキストから音声を作成でき、解説動画、研修、同様のナレーション用途に適しています。

設定可能なセッション入力

video-agent のリクエスト本文を通じて、ブランドキット、アバター選択、任意のファイル添付、コールバック、向きの設定を適用できます。

一般的なワークフロー

プロンプトから動画を作成
チームはプロンプトから初稿の動画を生成し、その後 API または webhook コールバックを通じて session と video の結果を取得できます。
コンテンツを翻訳して吹き替える
ローカライゼーションのワークフローでは、既存動画を複数の言語に翻訳しつつ、新しい音声に対して口の動きを一致させられます。
AI アシスタントとコーディングエージェントを接続する
開発者は、MCP、Skills、または Direct API を使用して、Claude、Cursor、その他の互換エージェント内で agentic なフローを構築できます。
ブランド化された動画バリエーションを制作する
プロダクトおよびマーケティングチームは、アバター、音声、ブランドキット、向きの設定を使用して、同じ API ワークフローからブランド化された動画バリエーションを作成できます。
繰り返しの動画タスクを自動化する
運用チームは、ターミナルまたは CI 環境から、ナレーション、lipsync の更新、バッチ動画生成ジョブを自動化できます。

Pros and Cons

Pros

Direct API、MCP、CLI ワークフローを含む複数の作成方法をカバーしています。
1 回完結と複数ターンのエージェントセッションの両方で、プロンプト駆動の動画生成をサポートしています。
動画翻訳、lipsync、avatars、voices、assets、webhooks、brand resources を API の範囲内でドキュメント化しています。
API キー作成から最初のリクエスト、動画取得までの明確なクイックスタート手順を提供しています。
$5 から始まる従量課金の入口があり、ドキュメントには Enterprise オプションも記載されています。

Cons

複数の機能が主にリファレンスページで説明されているため、公開ホームページでは一目で比較しにくいワークフローがあります。
ソースはフル機能のローコードやスタジオ風インターフェースよりも、API とエージェントのワークフローを重視しています。
料金やプランの詳細の一部はドキュメントページで要約されているだけなので、完全な条件を確認するには API と料金のドキュメントが必要です。

FAQ

HeyGen との主な統合方法は何ですか？

HeyGen は、Claude のような AI アシスタントを接続するための MCP、Claude Code や Cursor のような AI コーディングエージェントを拡張するための Skills、そしてプログラムによる制御のための Direct API の 3 つの統合方法をサポートしています。

リクエストはどのように認証しますか？

MCP は OAuth を使用し、API キーは不要です。Skills と Direct API は、HeyGen ダッシュボードの `X-Api-Key` ヘッダーで渡す API キーを使用します。

基本的な動画生成ワークフローはどのように動作しますか？

基本的な流れは、API キーを作成し、`POST` リクエストを `https://api.heygen.com/v3/video-agents` に送信し、その後 session と video の各エンドポイントをポーリングするか、webhook コールバックを使用します。

どのような料金オプションが記載されていますか？

従量課金は $5 から開始します。ドキュメントには、カスタムなスケーラビリティ、専任サポート、Digital Twin Creation API、Proofread API、割引料金を含む Enterprise プランも記載されています。

HeyGen はどのような API リソースを公開していますか？

API ドキュメントでは、session ベースの動画生成、動画翻訳、lipsync、voices、avatars、assets、webhooks、brand resources が説明されています。詳細はエンドポイントによって異なり、一部の機能は広範な製品ページではなく参照ページで案内されています。

Quick Facts

カテゴリ: 開発者向けツール
プラットフォーム: Web ドキュメントと API
主な利用者: 開発者と AI エージェント構築者
ドメイン: developers.heygen.com
API ベース URL: https://api.heygen.com
料金体系: 従量課金は $5 から