heygen

HeyGen API（非推奨）

このスキルは非推奨です。 代わりに、用途に特化した以下のスキルを使用してください。

• create-video — テキストプロンプトから動画を生成します（Video Agent API）
• avatar-video — 特定のアバター、音声、スクリプト、シーンを使って動画を作成します（v2 API）

このスキルは後方互換性のために残されていますが、今後のリリースで削除される予定です。

---

トーキングヘッド動画、解説動画、プレゼンテーションを生成するためのAIアバター動画作成APIです。

ツールの選択

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

タスク	MCP ツール	代替手段（直接API）
プロンプトから動画を生成	mcp__heygen__generate_video_agent	POST /v1/video_agent/generate
動画のステータスを確認／URLを取得	mcp__heygen__get_video	GET /v2/videos/{video_id}
アカウントの動画一覧を取得	mcp__heygen__list_videos	GET /v2/videos
動画を削除	mcp__heygen__delete_video	DELETE /v2/videos/{video_id}

HeyGen MCP ツールが利用できない場合は、リファレンスファイルに記載されているとおり、X-Api-Key: $HEYGEN_API_KEY ヘッダーを付けて直接HTTP APIを呼び出してください。

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

ほとんどの動画リクエストでは、Video Agentを優先してください。 prompt-optimizer.md のガイドラインに従い、シーン、タイミング、ビジュアルスタイルを指定してプロンプトを構成してください。

MCP ツールを使用する場合：

1. prompt-optimizer.md → visual-styles.md を使用して最適化したプロンプトを作成します
2. プロンプトと設定（duration_sec、orientation、avatar_id）を指定して mcp__heygen__generate_video_agent を呼び出します
3. 返された video_id を指定して mcp__heygen__get_video を呼び出し、ステータスを確認してダウンロードURLを取得します

MCP ツールを使用しない場合（直接API）：

1. prompt-optimizer.md → visual-styles.md を使用して最適化したプロンプトを作成します
2. POST /v1/video_agent/generate — video-agent.md を参照してください
3. GET /v2/videos/<id> — video-status.md を参照してください

ユーザーが以下を明示的に必要としている場合に限り、v2/video/generate を使用してください。

• AIによる変更を加えず、スクリプトを正確に使用する
• 特定の voice_id を選択する
• シーンごとに異なるアバター／背景を使用する
• シーンごとのタイミングを正確に制御する
• 指定した仕様でプログラムによる生成／一括生成を行う

クイックリファレンス

タスク	MCP ツール	参照先
プロンプトから動画を生成（簡単）	mcp__heygen__generate_video_agent	prompt-optimizer.md → visual-styles.md → video-agent.md
正確に制御して動画を生成	—	video-generation.md、avatars.md、voices.md
動画のステータスを確認／ダウンロードURLを取得	mcp__heygen__get_video	video-status.md
キャプションまたはテキストオーバーレイを追加	—	captions.md、text-overlays.md
合成用の透明動画	—	video-generation.md（WebM セクション）
Remotion と連携	—	remotion-integration.md

リファレンスファイル

基礎

• references/authentication.md - APIキーの設定と X-Api-Key ヘッダー
• references/quota.md - クレジットシステムと使用制限
• references/video-status.md - ポーリング方法とダウンロードURL
• references/assets.md - 画像、動画、音声のアップロード

動画作成の基本

• references/avatars.md - アバターとスタイルの一覧表示、avatar_id の選択
• references/voices.md - 音声、ロケール、速度／ピッチの一覧表示
• references/scripts.md - 台本の作成、間、ペース配分
• references/video-generation.md - POST /v2/video/generate と複数シーンの動画
• references/video-agent.md - プロンプト1つでの動画生成
• references/prompt-optimizer.md - Video Agent の効果的なプロンプトの作成（基本的なワークフローとルール）
• references/visual-styles.md - 詳細な仕様を含む20種類の名前付きビジュアルスタイル
• references/prompt-examples.md - 本番用プロンプトの完全な例とすぐに使えるテンプレート
• references/dimensions.md - 解像度とアスペクト比

動画のカスタマイズ

• references/backgrounds.md - 単色、画像、動画の背景
• references/text-overlays.md - フォントと配置を指定したテキストの追加
• references/captions.md - 自動生成されるキャプションと字幕

高度な機能

• references/templates.md - テンプレートの一覧表示と変数の置換
• references/photo-avatars.md - 写真からのアバター作成
• references/webhooks.md - Webhook エンドポイントとイベント

統合

• references/remotion-integration.md - Remotion のコンポジションでの HeyGen の使用