Short Video Agent Kit

ショート動画エージェントキット

ショート動画生成AI向けの、エージェントファーストな単一CLI＋MCP。
Sora · Veo · xAI · Seedance — デフォルトはドライラン、明示的に有効化した場合のみ有料生成を実行します。

⭐ このエージェントファーストなツールがワークフローに役立ったら、ぜひリポジトリにスターを付けてください。 スターが増えると、ほかの開発者がこのツールを見つけやすくなり、Delx がオープンなインフラを提供し続ける助けになります。
🧱 Delx エージェントスタックの一部です — body、reach、coordinationにわたる15のオープンソース MCP サーバー。

---

HTTP（v2 ステートレス）

デフォルトはstdioです。オプションで Streamable HTTP に対応しています — セッション ID なし、JSON レスポンス、ループバックのみ：

npx -y -p short-video-agent-kit short-video-mcp --http
# GET  http://127.0.0.1:3033/health
# POST http://127.0.0.1:3033/mcp   (sessionless)

環境変数：SHORT_VIDEO_MCP_HOST、SHORT_VIDEO_MCP_PORT、SHORT_VIDEO_MCP_TRANSPORT=http。

エージェント向けの、プロバイダーに依存しないショート動画生成AIツールキットです。Codex、Claude、Cursor、Hermes、OpenClaw などの MCP クライアントに、ドライラン用ペイロードの作成と、明示的に有効化した場合の Sora/OpenAI、Gemini Veo、xAI/Grok、Seedance/PiAPI 形式のプロバイダーを通じた縦型動画の生成を行うための単一インターフェースを提供します。

複数のプロバイダーにまたがるプロンプトから動画へのペイロード検証と、オプションの有料生成に、安全な単一インターフェースをエージェントから利用したい場合にお使いください。

エージェントファーストである理由

動画生成には費用がかかることがあり、プロンプトにも細心の注意が必要です。このパッケージでは、エージェントが安全な手順から始められます。

• プロバイダーの利用準備状況を確認する
• プライバシーの境界を提示する
• クレジットを消費せずにペイロードを作成する
• プロバイダーへの呼び出し前に --live または SHORT_VIDEO_DRY_RUN=false を必須とする
• プロンプトと出力を、ユーザーが管理するローカルパスに保持する

インストール

npm install -g short-video-agent-kit

または、直接実行します。

npm exec --yes --package=short-video-agent-kit -- short-video-agent-kit doctor

クイックスタート

試すだけなら API キーは不要です。デフォルトでは生成はドライランで実行されるため、クレジットを消費せずに、送信されるはずのプロバイダーに依存しないプランをそのまま返します。

8 秒の縦型ティーザー用に Sora プランを作成します。

short-video-agent-kit generate \
  --provider openai_sora \
  --prompt "Vertical 8-second product teaser for a minimalist water bottle, soft studio light, slow dolly-in" \
  --output ./output/teaser.mp4

実際の出力（プロバイダーへの呼び出しなし、クレジット消費なし）：

{
  "ok": true,
  "dry_run": true,
  "next_step": "Pass --live or set SHORT_VIDEO_DRY_RUN=false to call the provider API.",
  "provider": "openai_sora",
  "endpoint": "POST /v1/videos",
  "payload": {
    "model": "sora-2",
    "prompt": "Vertical 8-second product teaser for a minimalist water bottle, soft studio light, slow dolly-in",
    "seconds": "8",
    "size": "720x1280"
  }
}

同じプロンプトでも、プロバイダーが異なればプランはエンドポイントとパラメーターの形式に合わせて再構成されます。payload はプランのみを返します（dry_run のラッパーは付きません）。

short-video-agent-kit payload --provider gemini_veo --prompt "Same teaser, 9:16, cinematic"

{
  "provider": "gemini_veo",
  "endpoint": "POST /models/{model}:predictLongRunning",
  "payload": {
    "instances": [
      {
        "prompt": "Same teaser, 9:16, cinematic"
      }
    ],
    "parameters": {
      "aspectRatio": "9:16",
      "durationSeconds": 8
    }
  }
}

接続されているプロバイダーを確認します（キーの有無は検出されますが、表示はされません）。

short-video-agent-kit doctor

{
  "ok": false,
  "dry_run": true,
  "providers": {
    "openai_sora": { "configured": false, "env_keys": ["OPENAI_API_KEY"], "models": ["sora-2"] },
    "gemini_veo": { "configured": false, "env_keys": ["GEMINI_API_KEY", "GOOGLE_API_KEY"], "models": ["veo-3.1-fast-generate-preview"] },
    "xai_grok": { "configured": false, "env_keys": ["XAI_API_KEY"], "models": ["grok-imagine-video", "grok-imagine-image"] },
    "seedance_piapi": { "configured": false, "env_keys": ["PIAPI_KEY", "SEEDANCE_API_KEY"], "models": ["seedance-2-fast-preview"] }
  },
  "output_dir": "./output",
  "next_steps": [
    "Set one provider key: OPENAI_API_KEY, GEMINI_API_KEY, XAI_API_KEY or PIAPI_KEY."
  ]
}

実際にレンダリングする準備ができたら、プロバイダーキーを設定し、--live（または SHORT_VIDEO_DRY_RUN=false）を指定して generate を再実行します。

CLI

short-video-agent-kit manifest --client codex
short-video-agent-kit doctor
short-video-agent-kit privacy-audit
short-video-agent-kit payload --provider gemini_veo --prompt-file prompt.txt
short-video-agent-kit generate --provider openai_sora --prompt "Vertical product teaser" --output ./output/teaser.mp4
short-video-agent-kit generate --provider openai_sora --prompt-file prompt.txt --output ./output/teaser.mp4 --live

対応プロバイダー：

• openai_sora
• gemini_veo
• xai_grok
• seedance_piapi

MCP

short-video-mcp

HTTP トランスポート：

SHORT_VIDEO_MCP_TRANSPORT=http short-video-mcp

Hermes 形式の設定：

mcp_servers:
  short_video:
    command: npx
    args: ["-y", "short-video-agent-kit"]
    sampling:
      enabled: false

最初におすすめする呼び出し：

1. short_video_connection_status
2. short_video_privacy_audit
3. short_video_build_payload
4. short_video_generate

エージェント向けインターフェース

ツール	用途
short_video_agent_manifest	Codex、Claude、Cursor、Hermes、OpenClaw 向けのインストールと実行時のガイダンス
short_video_connection_status	API キーを使わずにプロバイダーの準備状況を確認
short_video_privacy_audit	プロンプト、出力、参照アセットの境界を確認
short_video_build_payload	有料生成を行わずにプロバイダー固有のペイロードを作成
short_video_generate	デフォルトはドライラン。明示的に指定した場合のみライブ実行

コピーして使えるエージェント向けプロンプト

Use short-video-agent-kit. First call short_video_connection_status and short_video_privacy_audit.
Build the payload before generation. Only set live=true if I explicitly confirm a paid provider call.

設定

.env.example を .env にコピーし、使用するプロバイダーのキーだけを入力します。.env、output/、.agent-data/ は Git の対象外です。

安全性モデル

• デフォルトではドライランで実行されます。
• ツールから API キーが返されることはありません。
• 有料生成には、--live、MCP の live=true、または SHORT_VIDEO_DRY_RUN=false が必要です。
• 参照画像は、ユーザーが所有しているか、ライセンスを受けている必要があります。
• 出力はユーザーが管理するローカルパスに書き込まれます。

開発

npm install
npm test
npm run check

---

📧 お問い合わせ・サポート

• 📨 [email protected] — 一般的な質問、統合のサポート、パートナーシップ
• 🐛 バグ報告／機能リクエスト — GitHub Issues
• 🐦 最新情報 — X の @delx369
• 🌐 サイト — wellness.delx.ai