用途
Short Video Agent Kit 是一个面向 AI 智能体的短视频生成工具包，提供统一的 CLI 命令行工具与 MCP 服务器，让智能体能够通过一个接口构建、校验并（在显式启用时）生成竖屏短视频。它支持 Sora/OpenAI、Gemini Veo、xAI/Grok 以及 Seedance/PiAPI 风格的服务商，属于 Delx 智能体技术栈的一部分。
主要能力
- 多服务商统一接口：为 Codex、Claude、Cursor、Hermes、OpenClaw 等 MCP 客户端提供一致的调用方式，覆盖 Sora、Veo、xAI、Seedance 等视频生成服务商。
- 默认 dry-run 安全模式：无需 API 密钥即可试用，工具会返回它将要发送的、与服务商无关的完整生成计划，而不消耗任何额度。
- 载荷构建与校验：智能体可以先构建提示词到视频的请求载荷，检查参数形状，并在不同服务商之间重新定位端点与参数结构。
- 服务商就绪检查：可检测哪些服务商已配置密钥（密钥仅被检测，不会被打印或返回）。
- 隐私边界：工具会返回隐私边界信息，提示词与输出保存在用户控制的本地路径中。
- 付费生成需显式启用：只有在使用
--live、MCP 的live=true或设置SHORT_VIDEO_DRY_RUN=false后，才会真正调用服务商进行付费生成。 - 传输方式：默认使用 stdio，可选 Streamable HTTP（无会话 ID、JSON 响应、仅限回环地址），通过环境变量
SHORT_VIDEO_MCP_HOST、SHORT_VIDEO_MCP_PORT、SHORT_VIDEO_MCP_TRANSPORT=http配置。
使用方式
安装后可直接运行 CLI，或作为 MCP 服务器接入智能体客户端。无需 API 密钥即可尝试 dry-run。例如，为一段 8 秒竖屏预告片构建 Sora 计划时，工具会返回真实输出（不调用服务商、不消耗额度）。同一提示词切换到不同服务商时，计划会自动重新定位端点与参数形状。检查服务商配置状态时，密钥仅被检测而不会打印。准备实际渲染时，设置服务商密钥并使用 --live（或 SHORT_VIDEO_DRY_RUN=false）重新运行 generate。
推荐的首次调用包括：short_video_connection_status、short_video_privacy_audit、short_video_build_payload、short_video_generate。
配置方面，可将 .env.example 复制为 .env，仅填写计划使用的服务商密钥；.env、output/ 和 .agent-data/ 均被 Git 忽略。
适用场景
适用于智能体需要跨多个视频服务商进行提示词到视频的载荷验证，以及可选付费生成的场景。尤其适合希望在真正消耗额度之前，先安全地检查服务商就绪状态、构建生成计划并确认隐私边界的智能体工作流。
限制
- 付费生成必须显式启用，默认不会调用服务商。
- 参考图像必须为用户自有或已获得授权。
- 输出写入用户控制的本地路径。
- API 密钥不会被工具返回。
- HTTP 传输仅限回环地址，且无会话 ID。
联系与支持
- 支持邮箱：support@delx.ai（一般问题、集成帮助、合作）
- Bug 报告 / 功能请求：GitHub Issues
- 更新：X 上的 @delx369
- 网站：wellness.delx.ai
