soundside.ai
官方基于MCP原生的人工智能媒体生成,采用x402按次付费模式。支持来自6家提供商的图像、视频、音频和音乐生成,可通过资源ID进行组合。使用Base链上的USDC结算。
你可以用 Soundside Ai MCP 做什么?
- 生成媒体资产 — 通过
create_audio和create_music请求图像、视频、音频、音乐或文本,并提供 Grok、MiniMax 或 Lyria 等提供商选项。 - 编辑和合成视频 — 使用编辑和合成工具请求裁剪、拼接、交叉淡化、调色或分屏合成。
- 分析媒体内容 — 获取现有媒体文件的技术元数据、转录或视觉质量检查。
- 训练自定义 LoRA 适配器 — 从您的媒体库中创建和管理用于图像或视频生成的个性化风格适配器。
- 发布到 X — 连接账户并执行受限读取以及持久的发布、回复、编辑或删除操作。
文档
Soundside — 开发者文档
面向智能体的 AI 媒体制作平台
Soundside 提供 21 个 MCP 工具,用于生成、编辑、合成、提取和分析媒体——包括图像、视频、音频、音乐、文本和商业工件——以及 LoRA 适配器微调和服务器端视频合成。可连接任意 MCP 客户端。OAuth/API 密钥积分覆盖所有已认证工具;符合条件的子集还支持通过 x402 在 Base 链上使用 USDC,无需账户。Compose、Recast 和 X 发布仅限认证积分使用。
2026-09 货币(2026-09-22)
- Recast: 签名 24 小时购买报价、有界运行支出、源/结果对比和最终动态审查。参见 Recast 了解认证积分定价。
- 已移除: Luma(完全移除)和 Runway 图像/视频生成。Runway 现仅限音频——通过
create_audio提供 TTS 和音效。- 已新增: Lyria 3 音乐生成(
create_music)、Grok TTS(create_audio)、Grok 每秒 × 分辨率视频定价、阿里巴巴 Wan 2.7 视频模型(国际默认)、MiniMax H3 视频适配器。- 对于符合条件的 x402 工具,请获取实时目录:
GET https://mcp.soundside.ai/api/x402/status。仅限认证的 Recast 报价来自remix_video(estimate_only=true)。
快速开始
# MCP endpoint
https://mcp.soundside.ai/mcp
# Auth: API key or x402 crypto payment
Authorization: Bearer <your-api-key>
POST https://mcp.soundside.ai/mcp
{"jsonrpc":"2.0","id":"1","method":"tools/list","params":{}}
工具(21 个)
生成
| 工具 | 功能 | 提供商 |
|---|---|---|
create_image | 文生图、角色参考 | Alibaba (Wan)、Creative Freedom(仅限认证)、Grok、MiniMax、Vertex AI |
create_video | 文生视频、图生视频、视频扩展 | Alibaba (Wan 2.7)、Creative Freedom(仅限认证)、Grok、MiniMax (Hailuo/H3)、Vertex AI (Veo 3.1) |
create_audio | TTS、音效、已弃用的转录垫片、语音克隆/设计 | Creative Freedom(仅限认证)、Grok、MiniMax、Runway(仅音频)、Vertex AI |
create_music | 根据歌词和风格提示生成音乐 | Lyria 3;Creative Freedom(仅限认证积分) |
create_text | LLM 聊天补全、结构化输出 | Grok、MiniMax、Qwen、Vertex AI (Gemini) |
create_artifact | 图表、演示文稿、文档、图表;捆绑模式用于多工件包 | plotly、pptx、docx、weasyprint、mermaid、gamma |
合成
| 工具 | 功能 |
|---|---|
compose_video | 服务器端流水线:丰富计划、并行生成资产、使用转场、音频闪避和叠加进行组装 |
remix_video | 使用签名购买报价重塑人物或重新换肤视频,保留源编辑/音频、同步对比和质量报告 |
编辑
| 工具 | 功能 |
|---|---|
edit_video | 核心视频变换:裁剪、拼接、交叉淡化、变速、循环、调色、烧录字幕、自定义 FFmpeg |
edit_audio | 在现有媒体上混合、替换或填充音频 |
compose_media | 添加文本、叠加媒体或构建分屏合成 |
apply_effect | 肯·伯恩斯效果、速度斜坡、胶片颗粒、暗角 |
extract_media | 提取帧、帧集或音轨 |
分析
| 工具 | 功能 | 提供商 |
|---|---|---|
analyze_media | 技术元数据、视觉 QA、转录、片段检测、EDL 导出 | Anthropic、Grok、OpenAI、Qwen、Vertex(+ soundside.ai ffprobe) |
适配器(LoRA)
| 工具 | 功能 | 后端 |
|---|---|---|
train_adapter | 从库媒体训练 LoRA 适配器 | DashScope (Wan)、Modal (Hunyuan/LTX) |
list_adapters | 列出您的 LoRA 适配器 | |
manage_adapter | 检查、部署、取消部署、删除或选择检查点 |
库管理
| 工具 | 功能 |
|---|---|
lib_list | 浏览项目、集合、资源、谱系、品牌套件;查询积分余额 |
lib_manage | 项目、集合、资源、品牌套件的 CRUD |
lib_share | 通过电子邮件与其他用户共享项目 |
发布
| 工具 | 功能 | 访问权限 |
|---|---|---|
publish_content | 有界的 X 账户读取以及持久的发布、回复、编辑、删除、点赞和转帖操作 | 仅限认证积分 |
定价
Soundside 使用积分系统:1 积分 = 0.01 美元。
- AI 生成 使用基于提供商成本的已发布计量费率,平台利润率约为 10%,除非列出了工具特定的固定费用。
- 平台工具(编辑引擎、库)为固定价格:$0.01/次调用;视觉 QA 为 $0.03。
- Compose 增加五积分仅成功计费的编排费用,并单独列出子调用。它需要 OAuth/API 密钥积分,不通过 x402 提供。
- Recast 在逐项处理费用之外,增加仅成功计费的服务费,为每转换源秒 $0.20(最低 $2)。当最终动态审查缺失或失败,或存在未解决的质量发现时,服务费将被免除;处理费用仍适用。报价执行付费分析。Recast 使用认证积分,而非 x402。参见 Recast 定价和购买令牌。
- X 账户操作 使用认证积分,不通过 x402 提供。发布为 2 积分,带 URL 时为 22 积分;回复使用相同类别,目标操作费用为 2 积分,读取按请求页面上限报价,但按实际返回数量结算(空结果费用为 0)。参见 X 账户操作。
- 每次调用估算和逐项费用有助于跟踪支出。单次调用价格不限制多调用工作流:Compose 没有签名购买报价或整个工作流支出上限。Recast 的单独签名报价合同限制其购买的运行。
实时定价始终可在以下位置获取:
GET https://mcp.soundside.ai/api/x402/status
这仅返回 x402 通道的机器可读的每工具、每提供商 USDC 价格。它不发布免费工具或仅限认证积分的 Compose、Recast 和 X 发布。价格由数据库驱动,可能发生变化——始终检查端点,而非硬编码。对于可变价格工具,发布金额为上限报价(最坏情况),而非典型结算价格——相关行带有 price_note 标记。
x402:使用加密货币按次付费
无需 API 密钥。通过 EIP-3009 transferWithAuthorization(链下签名,促进者支付 Gas)在 Base (L2) 上按工具调用支付 USDC。
Network: eip155:8453 (Base mainnet)
Token: USDC
Facilitator: Coinbase CDP
参见 x402 指南 了解完整设置。
指南
- 入门 — 5 分钟内完成首次 MCP 连接
- x402 按次付费 — 加密货币支付,无需账户
- 工具参考 — 所有 21 个工具的详细文档
- 重塑视频 — 付费报价、可重复安全购买、角色/世界变换和质量审查
- 构建原创短片 — 通过 MCP 进行辅助镜头规划、故事板审查和已接受素材组装
- 发布到 X — 连接 X 账户并从 MCP 发布
示例
- Python — API 密钥 — 使用 httpx 连接并生成
- Python — Recast 报价和购买 — 保存报价、购买其令牌并恢复作业状态
- 原创故事 — 预览 和 选定编辑 — 标准 30 秒 Compose 请求模板;使用前替换占位资源 ID
- Python — x402 — 使用 USDC 按次付费
- TypeScript — API 密钥 — Node.js MCP 客户端
- OpenClaw 技能 — OpenClaw 智能体的一行配置
本地验证(推送前钩子)
没有 GitHub 托管的 CI;验证在每次推送前本地运行。每个克隆启用一次:
git config core.hooksPath .githooks
要求:brew install gitleaks 和 uv。该钩子在每次推送时运行三道关卡:(1) 对传出提交范围进行 gitleaks 秘密扫描,(2) python3 scripts/validate_public_contract.py,以及 (3) pytest 套件(uv run --with pytest python -m pytest tests/ -q)。合约验证器将此门户与随附的 MCP 合约及其在兄弟仓库中的真实来源进行比较,因此推送需要三仓库工作区检出(../ssd-mcp 和 ../soundside-ai 位于此仓库旁边);独立克隆无法通过关卡。
链接
- 网站:soundside.ai
- MCP 端点:
https://mcp.soundside.ai/mcp - 实时定价:
https://mcp.soundside.ai/api/x402/status - GitHub:github.com/soundside-design/soundside-docs