mcpField
A
avatar-video

avatar-video

github.com/calesthioクリエイティブ・メディア72.7k1.1k 回インストール今日更新
リポジトリ

avatar-video について

HeyGenのAIアバター動画を細かく制御したい人向けのガイドです。APIでアバター、音声、台本、シーン、背景を設定し、単一または複数シーンの動画を生成します。字幕、テキスト表示、テンプレート、ステータス確認の手順も扱います。

主な機能

  1. 01アバターと音声の選択・プレビュー
  2. 02台本と複数シーン動画の設定
  3. 03背景、字幕、テキスト表示のカスタマイズ
  4. 04テンプレートと写真アバターの利用
  5. 05生成動画の状態確認とダウンロード

活用シーン

  1. 01指定したアバターに正確な台本を話させる動画の作成
  2. 02背景を切り替えた複数シーン動画の生成
  3. 03仕様を指定したアバター動画の一括生成

MCP 対応

HeyGen MCPツールが利用できる場合、動画の確認、一覧表示、削除にはそれらを優先するよう案内しています。動画生成とアバター・音声の一覧取得には直接APIを使います。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/calesthio/openmontage --skill avatar-video

インストール後、Claude Code で/avatar-videoを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
assets.md
avatars.md
backgrounds.md
captions.md
dimensions.md
photo-avatars.md
quota.md
remotion-integration.md
scripts.md
templates.md
text-overlays.md
video-generation.md
video-status.md
voices.md
webhooks.md

詳細

アバター動画

アバター、音声、スクリプト、シーン、背景を細かく制御して、AI アバター動画を作成できます。HeyGen の /v2/video/generate API を使って、設定を正確に指定しながら、単一または複数のシーンで構成される動画を作成できます。

認証

すべてのリクエストに X-Api-Key ヘッダーが必要です。環境変数 HEYGEN_API_KEY を設定してください。

curl -X GET "https://api.heygen.com/v2/avatars" \
  -H "X-Api-Key: $HEYGEN_API_KEY"

ツールの選択

HeyGen MCP ツール（mcp__heygen__*）が利用できる場合は、直接 HTTP API を呼び出すよりも優先して使用してください。認証とリクエスト形式の設定は自動的に処理されます。

タスクMCP ツール代替手段（直接 API）
動画のステータスを確認／URL を取得mcp__heygen__get_videoGET /v2/videos/{video_id}
アカウントの動画一覧を取得mcp__heygen__list_videosGET /v2/videos
動画を削除mcp__heygen__delete_videoDELETE /v2/videos/{video_id}

動画の生成（POST /v2/video/generate）とアバター／音声の一覧取得は、直接 API を呼び出して行います。以下のリファレンスファイルを参照してください。

デフォルトのワークフロー

  1. アバターを一覧表示する — GET /v2/avatars → アバターを選び、プレビューを確認して、avatar_id と default_voice_id を控えます。avatars.md を参照してください。
  2. 音声を一覧表示する（必要な場合） — GET /v2/voices → アバターの性別／言語に合った音声を選びます。voices.md を参照してください。
  3. スクリプトを書く — 各シーンが1つのコンセプトを扱うように構成します。scripts.md を参照してください。
  4. 動画を生成する — 各シーンのアバター、音声、スクリプト、背景を指定して POST /v2/video/generate を呼び出します。video-generation.md を参照してください。
  5. 完了までポーリングする — ステータスが completed になるまで GET /v2/videos/{video_id} を呼び出します。video-status.md を参照してください。

クイックリファレンス

タスク参照先
アバターの一覧表示とプレビューavatars.md
音声の一覧表示と選択voices.md
スクリプトの作成と構成scripts.md
動画の生成（単一または複数シーン）video-generation.md
カスタム背景の追加backgrounds.md
キャプション／字幕の追加captions.md
テキストオーバーレイの追加text-overlays.md
透過 WebM 動画の作成video-generation.md（WebM セクション）
テンプレートの使用templates.md
写真からアバターを作成photo-avatars.md
動画のステータス確認／ダウンロードvideo-status.md
アセット（画像、音声）のアップロードassets.md
Remotion との連携remotion-integration.md
Webhook の設定webhooks.md

このスキルと「動画を作成」スキルの使い分け

このスキルは細かな制御を行うためのものです。アバターを選び、正確なスクリプトを書き、各シーンを設定します。

ユーザーが単に動画のアイデアを説明し、スクリプトやアバター、ビジュアルなどを AI に任せたい場合は、代わりに create-video スキルを使用してください。

ユーザーの発言「動画を作成」スキルこのスキル
「X についての動画を作って」✓
「製品デモを作成して」✓
「アバター Y に Z と正確に言わせたい」✓
「背景の異なる複数シーンの動画」✓
「合成用の透過 WebM」✓
「自分のスクリプトにこの音声を使って」✓
「指定した仕様で動画を一括生成して」✓

リファレンスファイル

動画作成の基本
動画のカスタマイズ
高度な機能
連携
基本情報

ベストプラクティス

  1. 生成前にアバターをプレビューする — preview_image_url をダウンロードして、確定する前にユーザーがアバターを確認できるようにします
  2. アバターのデフォルト音声を使用する — ほとんどのアバターには、自然な結果が得られるようにあらかじめ対応付けられた default_voice_id があります
  3. フォールバック：性別を手動で合わせる — デフォルト音声がない場合は、アバターと音声の性別が一致するようにします
  4. 開発にはテストモードを使用する — test: true を設定すると、クレジットを消費せずに済みます（出力にはウォーターマークが入ります）
  5. 余裕のあるタイムアウトを設定する — 動画の生成には通常 5～15 分かかり、さらに時間がかかる場合もあります
  6. 入力を検証する — 生成前にアバター ID と音声 ID が存在することを確認します

コメント

Markdown 対応