ビデオエージェント ビデオスタジオ

🎬 VideoAgent Video Studio

使用するタイミング: ユーザーが動画の生成、テキストからの動画作成、画像のアニメーション化、短いクリップの作成、AI動画の生成を依頼したとき。

7つのバックエンドで短いAI動画を生成します。このスキルは適切なモード（テキストから動画または画像から動画）を選択し、最良の結果を得るためにプロンプトを強化し、動画URLを返します。

---

クイックリファレンス

ユーザーの意図	モード	標準時間
「〜の動画を作って」（画像なし）	text-to-video	4–10 秒
「この画像をアニメートして」/「これを動かして」	image-to-video	4–6 秒
「これを動画にして〜」	image-to-video	4–6 秒
シネマティック、ストーリー、広告	text-to-video（詳細なプロンプト推奨）	5–10 秒

生成モード

モード	説明	モデル
text-to-video	テキストプロンプトのみ → 動画	minimax, kling, veo, hunyuan, grok, seedance
image-to-video	単一画像 + プロンプト → アニメーションクリップ	minimax, kling, veo, pixverse, grok, seedance
reference-based	参照画像/動画 → 一貫性のある出力	minimax, kling, veo, hunyuan, grok, seedance

モデル（--model <id> で指定）

モデルID	T2V	I2V	参照	備考
minimax	✅	✅	✅	被写体参照画像、キャラクターの一貫性
kling	✅	✅	✅	マルチ要素/キャラクター/キーフレーム (O3)
veo	✅	✅	✅	Google Veo 3.1、複数参照画像
hunyuan	✅	—	✅	動画から動画へのスタイル変換
pixverse	—	✅	—	スタイライズされた画像から動画へ
grok	✅	✅	✅	参照動画による動画編集
seedance	✅	✅	✅	Seedance 1.5 Pro、同期オーディオ、4–12秒

完全なモデル詳細とエンドポイントリファレンス: references/models.md

---

動画の生成方法

ステップ 1 — モードを選択しプロンプトを強化

• テキストから動画: 被写体、アクション、カメラの動き、照明、スタイルを追加して拡充します。動きについて具体的に記述してください（例：「カメラがゆっくりズームイン」、「キャラクターが左から右に歩く」）。
• 画像から動画: 画像に適用する動きを記述します（例：「髪にそよぐ風」、「カメラがシーンをパンする」）。パターンについては references/prompt_guide.md を参照してください。

ステップ 2 — スクリプトを実行

テキストから動画:

node {baseDir}/tools/generate.js \
  --mode text-to-video \
  --prompt "<強化されたプロンプト>" \
  --duration <秒数> \
  --aspect-ratio <アスペクト比>

画像から動画:

node {baseDir}/tools/generate.js \
  --mode image-to-video \
  --prompt "<動きの説明>" \
  --image-url "<公開画像URL>" \
  --duration <秒数> \
  --aspect-ratio <アスペクト比>

パラメータ:

パラメータ	デフォルト	説明
--mode	text-to-video	text-to-video または image-to-video
--prompt	(必須)	シーンまたは動きの説明
--image-url	—	image-to-video で必須; 公開画像URL
--duration	5	長さ（秒）（通常 4–10）
--aspect-ratio	16:9	16:9, 9:16, 1:1, 4:3, 3:4
--model	auto	モデルID（例: kling, veo, grok, seedance）; auto = プロキシが選択

その他のコマンド:

コマンド	説明
node tools/generate.js --list-models	プロキシから利用可能なモデルを一覧表示
node tools/generate.js --status --job-id <id>	非同期ジョブのステータスを確認

ステップ 3 — 結果を返す

スクリプトはJSONを返します:

{
  "success": true,
  "mode": "text-to-video",
  "videoUrl": "https://...",
  "duration": 5,
  "aspectRatio": "16:9"
}

videoUrl をユーザーに送信します。

---

会話例

ユーザー: 「雨の中を歩く猫の短い動画を生成して、シネマティックに。」

node {baseDir}/tools/generate.js \
  --mode text-to-video \
  --prompt "雨の中を歩く猫、濡れた通り、ネオン反射、シネマティックな照明、スローモーション、4K" \
  --duration 5 \
  --aspect-ratio 16:9

---

ユーザー: 「この写真をアニメートして」（ユーザーが風景をアップロード）

node {baseDir}/tools/generate.js \
  --mode image-to-video \
  --prompt "空を横切る雲の優しい動き、微妙な草の動き、シネマティックな雰囲気" \
  --image-url "https://..." \
  --duration 5 \
  --aspect-ratio 16:9

---

ユーザー: 「コーヒーを注ぐ10秒の縦型動画、スローモーションで。」

node {baseDir}/tools/generate.js \
  --mode text-to-video \
  --prompt "白いカップにコーヒーを注ぐクローズアップ、スローモーション、立ち上る湯気、柔らかな照明、プロダクトショット" \
  --duration 10 \
  --aspect-ratio 9:16

---

ユーザー: 「Google Veoを使ってシネマティックなショットを。」

node {baseDir}/tools/generate.js \
  --mode text-to-video \
  --model veo \
  --prompt "曇り空を飛ぶドラゴン、シネマティックな照明、8秒" \
  --duration 8 \
  --aspect-ratio 16:9

---

ユーザー: 「この肖像画をアニメートして。」

node {baseDir}/tools/generate.js \
  --mode image-to-video \
  --model grok \
  --prompt "優しい微笑み、微妙な頭の動き" \
  --image-url "https://..." \
  --duration 5

---

セットアップ

デフォルトではAPIキーは不要です。 リクエストはホスト型プロキシを経由します。カスタムプロキシまたはトークンを使用する場合は以下を設定します:

変数	必須	説明
VIDEO_STUDIO_PROXY_URL	いいえ	プロキシベースURL
VIDEO_STUDIO_TOKEN	いいえ	プロキシが必要な場合の認証トークン

---

ナレッジベース

• references/prompt_guide.md — テキストから動画、画像から動画のプロンプトパターン。
• references/models.md — モデル一覧、機能、選択ガイド。
• references/calling_guide.md — モデルごとのエンドポイント詳細、入力パラメータ、特別な取り扱い。