Short Video Agent Kit

短视频 Agent 工具包

面向短视频 AI 视频的一体化 Agent 优先命令行工具 + MCP。
Sora · Veo · xAI · Seedance — 默认试运行，只有明确启用后才会付费生成。

⭐ 如果这个 Agent 优先工具对你的工作流有帮助，请为仓库点个星标。 星标能让其他开发者更容易发现这些工具，并帮助 Delx 持续交付开放基础设施。
🧱 属于 Delx Agent 技术栈 — 涵盖 身体、触达和协作 的 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。

面向 Agent 的供应商中立短视频 AI 视频工具包。它为 Codex、Claude、Cursor、Hermes、OpenClaw 和其他 MCP 客户端提供统一接口，用于构建试运行载荷，并在明确启用后，通过 Sora/OpenAI、Gemini Veo、xAI/Grok 和 Seedance/PiAPI 风格的供应商生成竖屏视频。

当 Agent 需要通过一个安全的统一接口，跨多个供应商验证提示词到视频的载荷并选择性地付费生成视频时，可使用此工具包。

为什么以 Agent 为先

视频生成可能成本高昂，而且对提示词很敏感。此软件包让 Agent 从安全的步骤开始：

• 检查供应商是否就绪
• 返回隐私边界
• 构建载荷而不消耗额度
• 调用供应商前必须使用 --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 重新运行 generate（或设置 SHORT_VIDEO_DRY_RUN=false）。

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

Agent 接入界面

工具	用途
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	默认采用试运行；仅在明确请求时进行实际生成

可复制粘贴的 Agent 提示词

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] — 一般问题、集成协助、合作事宜
• 🐛 Bug 报告/功能请求 — GitHub Issues
• 🐦 更新动态 — X 上的 @delx369
• 🌐 网站 — wellness.delx.ai