soundside.ai
官方MCP原生AI媒體生成,支援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 金鑰額度涵蓋所有需驗證的工具;符合資格的子集亦支援無需帳戶的 Base 鏈上 x402 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 每秒 × 解析度影片定價、Alibaba 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 | Ken Burns 效果、速度漸變、底片顆粒、暗角 |
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