videoagent-video-studio

🎬 VideoAgent Video Studio

用途： ユーザーが動画の生成、テキストからの動画作成、画像のアニメーション化、短いクリップの作成、または AI 動画の制作を依頼した場合に使用します。

7 つのバックエンドで短い AI 動画を生成します。このスキルは適切なモード（text-to-video または image-to-video）を選択し、最良の結果が得られるようプロンプトを調整して、動画の 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	1 枚の画像 + プロンプト → アニメーション動画	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	—	✅	—	スタイライズされた image-to-video
grok	✅	✅	✅	参照動画を使った動画編集
seedance	✅	✅	✅	Seedance 1.5 Pro、音声同期、4～12 秒

モデルの詳細とエンドポイントのリファレンスについては、references/models.md をご覧ください。

---

動画の生成方法

ステップ 1 — モードを選び、プロンプトを調整する

• Text-to-video：被写体、動作、カメラの動き、照明、スタイルを加えて詳細にします。動きは具体的に指定してください（例：「カメラがゆっくりズームインする」「キャラクターが左から右へ歩く」）。
• Image-to-video：画像に適用する動きを説明します（例：「髪を優しく揺らすそよ風」「カメラがシーンを横切るようにパンする」）。パターンについては、references/prompt_guide.md をご覧ください。

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

Text-to-video：

node {baseDir}/tools/generate.js \
  --mode text-to-video \
  --prompt "<enhanced prompt>" \
  --duration <seconds> \
  --aspect-ratio <ratio>

Image-to-video：

node {baseDir}/tools/generate.js \
  --mode image-to-video \
  --prompt "<motion description>" \
  --image-url "<public image URL>" \
  --duration <seconds> \
  --aspect-ratio <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 "A cat walking through rain, wet streets, neon reflections, cinematic lighting, slow motion, 4K" \
  --duration 5 \
  --aspect-ratio 16:9

---

ユーザー：「この写真をアニメーションにして」(ユーザーが風景写真をアップロード)

node {baseDir}/tools/generate.js \
  --mode image-to-video \
  --prompt "Gentle clouds moving across the sky, subtle grass movement, cinematic atmosphere" \
  --image-url "https://..." \
  --duration 5 \
  --aspect-ratio 16:9

---

ユーザー：「コーヒーを注ぐ様子を、スローモーションで 10 秒の縦型動画にして。」

node {baseDir}/tools/generate.js \
  --mode text-to-video \
  --prompt "Close-up of coffee pouring into a white cup, slow motion, steam rising, soft lighting, product shot" \
  --duration 10 \
  --aspect-ratio 9:16

---

ユーザー：「映画のようなショットに Google Veo を使って。」

node {baseDir}/tools/generate.js \
  --mode text-to-video \
  --model veo \
  --prompt "A dragon flying through cloudy skies, cinematic lighting, 8s" \
  --duration 8 \
  --aspect-ratio 16:9

---

ユーザー：「このポートレートをアニメーションにして。」

node {baseDir}/tools/generate.js \
  --mode image-to-video \
  --model grok \
  --prompt "Gentle smile, subtle head turn" \
  --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 — モデルごとのエンドポイントの詳細、入力パラメーター、特別な処理。