MCP 伺服器

使用 API 金鑰，將 Claude Code、Cursor、Codex、VS Code 與其他 MCP 用戶端連接至 SeedRouter 的影像與影片模型。

SeedRouter 執行著一個遠端 Model Context Protocol 伺服器。AI 代理可以透過它列出影像與影片模型、讀取模型的請求結構與價格、提交生成任務並取得結果，無需你撰寫串接程式碼。

https://api.seedrouter.ai/v1/mcp

傳輸方式： Streamable HTTP，無狀態。伺服器支援協定版本 2026-07-28，也支援以 initialize 交握開始的早期版本，最早可追溯至 2024-11-05。
認證： 將你的 SeedRouter API 金鑰作為 Bearer 權杖傳送，即 Authorization: Bearer YOUR_API_KEY。請在 API 金鑰頁面建立金鑰；詳見認證。
計費： 與 HTTP API 相同。每次 submit_task 呼叫相當於向對應的任務端點傳送一次請求，計費方式也相同。

僅支援透過 OAuth 登入、且沒有自訂標頭輸入欄位的用戶端，目前還無法連接。

連接用戶端

API 金鑰頁面提供透過 MCP 連接按鈕，可為以下各用戶端的設定填入你的一把金鑰。

Claude Code

claude mcp add --transport http seedrouter https://api.seedrouter.ai/v1/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Cursor

加入至 ~/.cursor/mcp.json，或專案中的 .cursor/mcp.json：

{
  "mcpServers": {
    "seedrouter": {
      "url": "https://api.seedrouter.ai/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Codex CLI

Codex 從環境變數讀取金鑰：

export SEEDROUTER_API_KEY=YOUR_API_KEY
codex mcp add seedrouter --url https://api.seedrouter.ai/v1/mcp \
  --bearer-token-env-var SEEDROUTER_API_KEY

Codex 儲存的是變數名稱，而非金鑰。請在已設定 SEEDROUTER_API_KEY 的 shell 中啟動 Codex，例如在 shell 設定檔中匯出該變數。

VS Code

加入至 .vscode/mcp.json：

{
  "servers": {
    "seedrouter": {
      "type": "http",
      "url": "https://api.seedrouter.ai/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

其他支援遠端 Streamable HTTP 伺服器與自訂 Authorization 標頭的用戶端，也採用相同的設定方式。

工具

工具	用途	是否從餘額扣款
`list_models`	列出 `submit_task` 接受的模型 ID，並附上各模型的文件連結。選用參數 `endpoint`：`images` 或 `videos`。	否
`get_model_schema`	回傳模型請求本文的 JSON Schema。JSON Schema 無法表達的規則，例如條件式要求與跨欄位限制，由 API 強制執行，並在模型文件頁中說明。	否
`get_pricing`	回傳模型目前以美元計價的公開價格，資料來自計費所用的同一套即時費率，包含適用的模型價格級距。	否
`submit_task`	提交一個任務：傳入 `model` 與 `input`，後者為 `get_model_schema` 描述的請求本文。回傳任務 ID。	是，每次建立任務的呼叫都會扣款
`get_task`	回傳任務狀態與輸出。選用參數 `wait_seconds`（0–50）可在任務仍在執行時於伺服器端等待。	否
`get_balance`	回傳金鑰所屬帳號的剩餘餘額，單位為美元。	否

submit_task 不具冪等性。重試呼叫會再建立一個任務並再次扣款，因此，在重試未收到結果的呼叫前，請先檢查 get_task、get_balance 或你的任務歷史。

典型流程

呼叫 list_models，傳入 endpoint: "images"。
對選定的模型呼叫 get_model_schema。
如需先查看費率，可呼叫 get_pricing。
呼叫 submit_task，傳入 model 與符合結構要求的 input。
呼叫 get_task，傳入 wait_seconds: 50；在 status 為 processing 時重複呼叫，然後讀取 output。Seedance 任務會先回報 queued 與 running，再變為 succeeded。

與 HTTP API 一樣，生成過程是非同步的：任務一旦受理，submit_task 就會回傳。wait_seconds 讓代理無需循環輪詢，但較長的影片仍可能需要多次呼叫 get_task。如果等待期間的狀態查詢因流量限制或伺服器錯誤等暫時性原因失敗，get_task 會回傳最後一次的 processing 結果，而非錯誤；請再次呼叫。

沿用 HTTP API 的規則

參考圖片、影片與音訊必須使用公開的 http(s) URL。不接受 Base64 輸入。
HTTP API 回應時，其回應本文會原樣作為工具結果回傳，使用相同的錯誤碼。請求到達 HTTP API 之前發生的錯誤，例如未知模型或無效的工具引數，會以純文字錯誤訊息回傳。若金鑰在 MCP 端點本身遭到拒絕，則回傳 HTTP 401。
失敗的任務不計費。
預設情況下，一個帳號最多可同時執行 50 個影像與影片任務。在執行中的任務完成前，繼續提交會回傳 HTTP 429 與錯誤碼 30002；詳見透過 AI 代理使用 SeedRouter。
模型 ID 與參數以各模型的文件為準。模型在 API 上線後，就會出現在 list_models 中。
MCP 不提供文字模型。請透過文字端點呼叫，或依在 SeedRouter 上執行程式開發代理中的說明，使用文字模型執行程式開發代理。

On this page