mcpField
C
create-video

create-video

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

create-video について

create-videoは、HeyGenでテキストプロンプトから動画を生成するスキルです。プロンプトの作成と生成手順に加え、HeyGen MCPツールまたは直接APIを使った状態確認やダウンロードURLの取得方法を案内します。

主な機能

  1. 01プロンプトからの動画生成
  2. 02プロンプト最適化のガイド
  3. 03動画の状態とURLの取得
  4. 04アカウント動画の一覧と削除
  5. 05参照ファイルの利用ガイド

活用シーン

  1. 01プロンプトから製品デモ動画を作成
  2. 02シーンを個別指定せずに動画を生成
  3. 03生成動画の状態とダウンロードURLを確認

MCP 対応

HeyGen MCPツールが利用できる場合、動画生成、状態確認、一覧表示、削除に使用します。代替手段としてHeyGen APIの直接呼び出しも記載されています。

インストール

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

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

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

同梱ファイル

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

references/
assets.md
dimensions.md
prompt-examples.md
prompt-optimizer.md
quota.md
video-agent.md
video-status.md
visual-styles.md
webhooks.md

詳細

動画を作成

テキストプロンプトから動画を完成させます。作成したい内容を説明すると、AI がスクリプトの作成、アバターの選択、ビジュアル、ナレーション、ペース配分、字幕を自動で処理します。

認証

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

curl -X POST "https://api.heygen.com/v1/video_agent/generate" \
  -H "X-Api-Key: $HEYGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Create a 60-second product demo video."}'

ツールの選択

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

タスクMCP ツールフォールバック（直接 API）
プロンプトから動画を生成mcp__heygen__generate_video_agentPOST /v1/video_agent/generate
動画のステータス確認／URL の取得mcp__heygen__get_videoGET /v2/videos/{video_id}
アカウントの動画を一覧表示mcp__heygen__list_videosGET /v2/videos
動画を削除mcp__heygen__delete_videoDELETE /v2/videos/{video_id}

HeyGen MCP ツールが利用できない場合は、リファレンスファイルに記載されたとおりに直接 HTTP API 呼び出しを使用してください。

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

シーン、タイミング、ビジュアルスタイルを指定してプロンプトを構成するには、必ず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を参照してください

クイックリファレンス

タスクMCP ツール参照先
プロンプトから動画を生成mcp__heygen__generate_video_agentprompt-optimizer.md → visual-styles.md → video-agent.md
動画のステータス確認／ダウンロード URL の取得mcp__heygen__get_videovideo-status.md
プロンプト用の参照ファイルをアップロード—assets.md

このスキルと Avatar Video の使い分け

このスキルはプロンプトベースの動画作成に使用します。作成したい内容を説明すれば、あとは AI が処理します。

特定のアバター、正確なスクリプト、シーンごとの音声／背景設定、または複数シーンの構成を細かく制御する必要がある場合は、代わりにavatar-videoスキルを使用してください。

ユーザーのリクエストこのスキルAvatar Video スキル
「X についての動画を作って」✓
「製品デモを作成して」✓
「アバター Y に Z と正確に言わせたい」✓
「背景が異なる複数シーンの動画」✓
「合成用の透明な WebM」✓

リファレンスファイル

コアワークフロー
基礎

ベストプラクティス

  1. プロンプトを最適化する — いまひとつの結果とプロフェッショナルな結果の違いは、すべてプロンプトの品質によって決まります。必ずプロンプトオプティマイザーを使用してください。
  2. 長さを指定する — 長さを予測しやすくするには、config.duration_secを使用してください。
  3. 必要に応じてアバターを固定する — 動画間で一貫性を保つには、config.avatar_idを使用してください。
  4. 参考ファイルをアップロードする — エージェントがブランドや製品を理解しやすくなります。
  5. プロンプトを繰り返し調整する — 結果に基づいて改善してください。Video Agentは素早い反復に最適です。

コメント

Markdown 対応