用途
vap-showcase 定位为「面向 AI 智能体的媒体执行控制层」(Media Execution Control Layer for AI Agents),核心目标是在 AI 智能体调用媒体生成能力时提供成本控制,采用「预留—执行—扣费/退款」(reserve-execute-burn/refund)的计费模式,并支持生成前的事前报价与预算约束。
同时,该仓库是 VAP Media API 集成的公开 GitHub 与 MCP 发现入口,用于让支持 MCP 的客户端与智能体工作流接入 VAP 的媒体工具。
主要能力
- 媒体执行控制:预留—执行—扣费/退款模式,事前报价与预算约束。
- 媒体生成:支持 Flux2 Pro、Veo 3.1、Suno V5。
- 后处理:基于 FFmpeg 做格式转换、音频归一化。
- MCP 接入:MCP 端点 https://api.vapagent.com/mcp ,支持 Claude Desktop、Claude Code、Cursor 兼容的 MCP 客户端及其他调用 VAP 媒体工具的智能体工作流。对不支持直接设置请求头的客户端,可使用本地代理 mcp/vap_mcp_proxy.py 并设置 VAP_API_KEY。
- Media API:图像、视频、音乐工作流的统一生成 API。当前公开模型接口包括 Pimo AI-Video、Aura Image Turbo、Pira V5.5。
- Coding Plan API:兼容 OpenAI 的 API,面向编码智能体、IDE、编辑器与自动化工作流,由 Nemesis Deep Coder 提供支持,模型 ID 为 vap-code。
- 产品界面:AI Room 是对话式创作工作区,定制训练的 AI 智能体使用会话上下文来创建图像、视频、语音和音乐。
使用方式
开发者入口(Developer Hub):https://vapagent.com/developer/
Media API:
- API 基础地址:https://api.vapagent.com/api/v1
- 创建生成:POST /api/v1/generations
- 创建操作:POST /api/v1/operations
- 认证:产品范围的 VAP Media API key
- MCP 端点:https://api.vapagent.com/mcp
Coding Plan API:
- 兼容 OpenAI 的 API 基础地址:https://api.vapagent.com/v1
- 模型 ID:vap-code
- Responses 端点:POST /v1/responses
- Chat Completions 端点:POST /v1/chat/completions
- 认证:产品范围的 VAP Coding Plan API key
产品入口:https://vapagent.com/new API 基础地址:https://api.vapagent.com/api/v1
MCP 接入示例(Claude Desktop):仓库提供 Claude Desktop 示例配置;对于不支持直接设置请求头的客户端,使用本地代理 mcp/vap_mcp_proxy.py 并设置 VAP_API_KEY。
适用场景
- 需要在 AI 媒体生成流程中控制成本、事前获得报价并约束预算的智能体应用。
- 通过 MCP 客户端(如 Claude Desktop、Claude Code、Cursor 兼容客户端)调用媒体生成工具的智能体工作流。
- 需要在图像、视频、音乐之间统一调用生成 API 的工作流。
- 需要兼容 OpenAI 接口的编码智能体、IDE、编辑器与自动化流程。
- 在对话式创作工作区中借助会话上下文生成图像、视频、语音与音乐。
限制
- 除上述公开模型接口与计划名称(Lite、Pro、Max 月度 Room 计划)外,具体收费价格、额度与配额细节暂未提供。
- 各模型的具体参数、能力边界与输出规格暂未提供。
- 预算约束、报价与扣费/退款机制的具体计算规则与实现细节暂未提供。
- FFmpeg 后处理支持的具体格式范围暂未提供。
其他信息
- 网站:https://vapagent.com/
- AI Room:https://vapagent.com/new
- MCP 指南:https://vapagent.com/mcp.html
- Webhooks:https://vapagent.com/webhooks.html
- 状态页:https://vapagent.com/status.html
- 支持邮箱:support@vapagent.com
- 模型页面:https://vapagent.com/models/nemesis-deep-coder.html
- Harness 指南:https://vapagent.com/integrations/coding-harnesses.html
- 发现文件:server.json(MCP Registry 服务器元数据)、mcp.json(MCP 包元数据)、glama.json(Glama MCP 列表元数据)、mcp/tools.json(MCP 工具 schema 元数据)、mcp/vap_mcp_proxy.py(面向 MCP 客户端的本地 stdio/http 代理)
- 许可证:MIT License,详见 LICENSE