内容
<!-- delx header v2 -->
<h1 align="center">短视频代理工具包</h1>
<div align="center">
<img src="assets/banner.png" alt="短视频代理工具包" width="85%" />
</div>
<h3 align="center">
适用于短视频AI的代理优先CLI + MCP。<br>Sora · Veo · xAI · Seedance — 默认干预运行，显式启用付费生成。
</h3>
<p align="center">
<a href="https://www.npmjs.com/package/short-video-agent-kit"><img src="https://img.shields.io/npm/v/short-video-agent-kit?style=for-the-badge&labelColor=0F172A&color=10B981&logo=npm&logoColor=white" alt="npm 版本" /></a>
<a href="https://www.npmjs.com/package/short-video-agent-kit"><img src="https://img.shields.io/npm/dm/short-video-agent-kit?style=for-the-badge&labelColor=0F172A&color=0EA5A3&logo=npm&logoColor=white" alt="npm 下载量" /></a>
<a href="LICENSE"><img src="https://img.shields.io/badge/LICENSE-MIT-22C55E?style=for-the-badge&labelColor=0F172A" alt="MIT 许可证" /></a>
<a href="https://modelcontextprotocol.io"><img src="https://img.shields.io/badge/BUILT_FOR-MCP-7C3AED?style=for-the-badge&labelColor=0F172A" alt="为MCP构建" /></a>
</p>
<p align="center">
<a href="https://github.com/davidmosiah/short-video-agent-kit/stargazers"><img src="https://img.shields.io/github/stars/davidmosiah/short-video-agent-kit?style=for-the-badge&labelColor=0F172A&color=FBBF24&logo=github" alt="GitHub 星标" /></a>
<a href="https://github.com/davidmosiah/short-video-agent-kit/actions/workflows/ci.yml"><img src="https://github.com/davidmosiah/short-video-agent-kit/actions/workflows/ci.yml/badge.svg" alt="CI 状态" /></a>
<a href="https://github.com/davidmosiah"><img src="https://img.shields.io/badge/PART_OF-Delx_Agent_Stack-0EA5A3?style=for-the-badge&labelColor=0F172A" alt="Delx 代理栈的一部分" /></a>
<a href="https://github.com/davidmosiah/short-video-agent-kit"><img src="https://img.shields.io/badge/CATEGORY-Reach-7C3AED?style=for-the-badge&labelColor=0F172A" alt="类别" /></a>
</p>
> ⭐ **如果这个代理优先工具对您的工作流程有帮助，请给仓库加星。** 星标使这个工具对其他构建者更容易发现，并帮助 Delx 持续提供开放的基础设施。<br>
> 🧱 [Delx 代理栈](https://github.com/davidmosiah) 的一部分 — 15 个开源 MCP 服务器，涵盖 **身体、触及和协调**。
---
<!-- /delx header v2 -->
提供商中立的短视频 AI 工具包，适用于代理。它为 Codex、Claude、Cursor、Hermes、OpenClaw 等 MCP 客户端提供了一个接口，用于构建干预运行的有效载荷，并在显式启用时通过 Sora/OpenAI、Gemini Veo、xAI/Grok 和 Seedance/PiAPI 样式的提供商生成垂直视频。
在代理需要一个安全接口用于提示到视频的有效载荷验证和多个提供商的付费生成时使用。
## 为什么它是代理优先的
视频生成可能很昂贵且对提示敏感。该软件包使代理从安全步骤开始：
- 检查提供商的准备情况
- 返回隐私边界
- 在不花费积分的情况下构建有效载荷
- 在调用提供商之前需要 `--live` 或 `SHORT_VIDEO_DRY_RUN=false`
- 将提示和输出保存在本地用户控制的路径中
## 安装
```bash
npm install -g short-video-agent-kit
```
或直接运行：
```bash
npm exec --yes --package=short-video-agent-kit -- short-video-agent-kit doctor
```
## 快速入门
不需要 API 密钥即可试用 — 默认情况下生成是干预运行的，因此工具包返回它将在不花费积分的情况下发送的确切提供商中立计划。
为 8 秒垂直预告片构建 Sora 计划：
```bash
short-video-agent-kit generate \
--provider openai_sora \
--prompt "垂直 8 秒产品预告片，用于 minimalist 水瓶，软工作室灯光，慢 dolly-in" \
--output ./output/teaser.mp4
```
实际输出（无提供商调用，无积分支出）：
```json
{
"ok": true,
"dry_run": true,
"next_step": "传递 --live 或设置 SHORT_VIDEO_DRY_RUN=false 以调用提供商 API。",
"provider": "openai_sora",
"endpoint": "POST /v1/videos",
"payload": {
"model": "sora-2",
"prompt": "垂直 8 秒产品预告片，用于 minimalist 水瓶，软工作室灯光，慢 dolly-in",
"seconds": "8",
"size": "720x1280"
}
}
```
相同的提示，不同的提供商 — 计划重新定位端点和参数形状为您。`payload` 只返回计划（无 `dry_run` 包装）：
```bash
short-video-agent-kit payload --provider gemini_veo --prompt "相同的预告片，9:16，电影风格"
```
```json
{
"provider": "gemini_veo",
"endpoint": "POST /models/{model}:predictLongRunning",
"payload": {
"instances": [
{
"prompt": "相同的预告片，9:16，电影风格"
}
],
"parameters": {
"aspectRatio": "9:16",
"durationSeconds": 8
}
}
}
```
检查哪些提供商已连接（检测密钥，从不打印）：
```bash
short-video-agent-kit doctor
```
```json
{
"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": [
"设置一个提供商密钥：OPENAI_API_KEY、GEMINI_API_KEY、XAI_API_KEY 或 PIAPI_KEY。"
]
}
```
当您准备好实际渲染时，设置一个提供商密钥并使用 `--live`（或 `SHORT_VIDEO_DRY_RUN=false`）重新运行 `generate`。
## CLI
```bash
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 "垂直产品预告片" --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
```bash
short-video-mcp
```
HTTP 传输：
```bash
SHORT_VIDEO_MCP_TRANSPORT=http short-video-mcp
```
Hermes 样式配置：
```yaml
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` | 默认干预运行，仅在显式请求时实时运行 |
## 复制粘贴代理提示
```text
使用 short-video-agent-kit。首先调用 short_video_connection_status 和 short_video_privacy_audit。
在生成之前构建有效载荷。只有当我明确确认付费提供商调用时，才设置 live=true。
```
## 配置
复制 `.env.example` 到 `.env` 并仅填写您计划使用的提供商密钥。`.env`、`output/` 和 `.agent-data/` 被 Git 忽略。
## 安全模型
- 干预运行是默认的。
- 工具从不返回 API 密钥。
- 付费生成需要 `--live`、MCP `live=true` 或 `SHORT_VIDEO_DRY_RUN=false`。
- 参考图像必须是用户拥有的或许可的。
- 输出写入用户控制的本地路径。
## 开发
```bash
npm install
npm test
npm run check
```
---
## 📧 联系与支持
- 📨 **support@delx.ai** — 一般问题、集成帮助、合作伙伴
- 🐛 **错误报告/功能请求** — [GitHub 问题](https://github.com/davidmosiah/short-video-agent-kit/issues)
- 🐦 **更新** — [@delx369](https://x.com/delx369) 在 X 上
- 🌐 **网站** — [wellness.delx.ai](https://wellness.delx.ai)
