HeyGen Automation
Composio MCP 統合を通じて、AI を活用した動画作成ワークフローを自動化します。アバターやテンプレートの閲覧、テンプレートからのパーソナライズ動画生成、処理ステータスの追跡、共有可能 URL の取得をすべてオーケストレーションできます。
ツールキットドキュメント: composio.dev/toolkits/heygen
セットアップ
https://rube.app/mcpで Composio MCP サーバーを通じて HeyGen アカウントを接続します。- アクティブな接続がない場合、エージェントが認証リンクを促します。
- 接続が完了すると、すべての
HEYGEN_*ツールが実行可能になります。
コアワークフロー
1. 利用可能なテンプレートの閲覧
動画作成のために、HeyGen ライブラリから事前デザインされたアバターテンプレートを取得します。
ツール: HEYGEN_V2_TEMPLATES
パラメータは不要です。テンプレート ID、名前、プレビュー画像、カスタマイズオプションが返されます。
動画生成前にこれを使用してテンプレートを発見してください。各テンプレートには生成に必要な一意の ID があります。
2. テンプレート詳細と変数の検査
すべての変数、シーンマッピング、カスタマイズオプションを含むテンプレートの完全な構造を取得します。
ツール: HEYGEN_RETRIEVE_TEMPLATE_DETAILS_V3
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
template_id | string | はい | HEYGEN_V2_TEMPLATES または HeyGen ダッシュボードからのテンプレート ID |
これは動画生成の 必須の前提条件 です。どの変数を設定する必要があるかを正確に示します。
3. 利用可能なアバターの閲覧
動画作成で使用可能なすべてのリアルなアバターをリスト表示します。キャラクターをシーンにマッピングするのに役立ちます。
ツール: HEYGEN_V2_AVATARS
パラメータは不要です。アバター識別子、名前、プレビュー画像が返されます。
リストはページ分割されている場合があります。完全なセットを取得するには追加の呼び出しが必要な場合があります。
4. テンプレートからの動画生成
テンプレートに変数とコンテンツを設定して、カスタマイズされた動画を作成します。
ツール: HEYGEN_V2_TEMPLATE_GENERATE
動画タイトルと、HEYGEN_RETRIEVE_TEMPLATE_DETAILS_V3 で発見したすべてのテンプレート変数を指定します。必須の変数はすべて、正確な名前と型で指定する必要があります。
5. 動画処理ステータスの確認
生成中の動画の処理ステータスをポーリングし、メタデータを取得します。
ツール: HEYGEN_RETRIEVE_VIDEO_STATUS_DETAILS
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
video_id | string | はい | 生成 API から返された動画 ID |
返される URL は 7 日後に期限切れになりますが、このエンドポイントを再度呼び出すことで再生成できます。
6. 共有可能な動画 URL の取得
認証なしで誰でも動画を視聴できる、公開共有可能なリンクを生成します。
ツール: HEYGEN_RETRIEVE_SHARABLE_VIDEO_URL
video_id を指定して、配布用の公開 URL を取得します。
既知の問題点
| 問題点 | 詳細 |
|---|---|
| すべてのテンプレート変数が必要 | HEYGEN_V2_TEMPLATE_GENERATE は HEYGEN_RETRIEVE_TEMPLATE_DETAILS_V3 のすべての変数を正確な名前と型で要求します。欠落または誤った名前のフィールドはシーンを壊すか、生成に失敗します。 |
| 最初に必ずテンプレートを検査 | 生成前に HEYGEN_RETRIEVE_TEMPLATE_DETAILS_V3 をスキップしないでください。マルチシーンテンプレートは複雑な変数構造を持ちます。 |
| 動画 URL の有効期限 | HEYGEN_RETRIEVE_VIDEO_STATUS_DETAILS からの URL は 7 日後に期限切れになります。エンドポイントを再度呼び出して再生成してください。 |
| ページ分割されたアバターリスト | HEYGEN_V2_AVATARS はページ分割された結果を返す場合があります。完全なライブラリを取得するには追加の呼び出しが必要な場合があります。 |
| 処理時間は変動する | 動画生成は非同期です。出力 URL を使用する前に、HEYGEN_RETRIEVE_VIDEO_STATUS_DETAILS をポーリングしてステータスが完了になるまで待機してください。 |
クイックリファレンス
| ツールスラッグ | 目的 |
|---|---|
HEYGEN_V2_TEMPLATES | 利用可能な動画テンプレートの一覧表示 |
HEYGEN_RETRIEVE_TEMPLATE_DETAILS_V3 | テンプレート変数とシーン構造の取得 |
HEYGEN_V2_AVATARS | 利用可能な AI アバターの閲覧 |
HEYGEN_V2_TEMPLATE_GENERATE | テンプレートから動画を生成 |
HEYGEN_RETRIEVE_VIDEO_STATUS_DETAILS | 動画処理ステータスの確認と URL の取得 |
HEYGEN_RETRIEVE_SHARABLE_VIDEO_URL | 公開共有可能な動画リンクの取得 |
Powered by Composio