AI Agents
透過 AI 代理使用 SeedRouter
透過 MCP 伺服器、代理技能或 HTTP API 將程式開發代理與 AI 助手連接至 SeedRouter，並瞭解代理需要考量的限制。
代理可以透過三種方式使用 SeedRouter。這些方式共用相同的 API 金鑰、餘額、模型與限制，計費方式也相同。
| 方式 | 適用情境 | 設定 |
|---|---|---|
| MCP 伺服器 | Claude Code、Cursor、Codex、VS Code 與其他 MCP 用戶端 | 加入 https://api.seedrouter.ai/v1/mcp，並將你的 API 金鑰放在 Bearer 標頭中 |
| 代理技能 | 載入 Agent Skills 的代理 | 技能索引位於 /.well-known/agent-skills/index.json |
| HTTP API | 你自己的程式碼，或為你撰寫程式碼的代理 | 快速上手 |
如果要讓代理本身使用 SeedRouter 的文字模型執行，請參閱在 SeedRouter 上執行程式開發代理。
只需設定一次金鑰
請在 API 金鑰頁面建立金鑰並匯出為環境變數，讓代理能夠讀取，同時避免將金鑰寫入專案檔案：
export SEEDROUTER_API_KEY=YOUR_API_KEYAPI 金鑰頁面也提供透過 MCP 連接按鈕，可為各 MCP 用戶端產生可直接使用的設定。
代理如何使用 SeedRouter
- 尋找模型：透過 MCP 呼叫
list_models，或查看/llms.txt中的模型清單。每個有到達網頁的模型都在https://seedrouter.ai/models/<slug>/llms.txt提供純文字摘要，包含參數、價格與範例。 - 讀取輸入結構：透過 MCP 呼叫
get_model_schema，或查看模型文件頁。 - 使用公開的媒體 URL：生成端點只接受以公開
http(s)URL 提供的參考圖片、影片與音訊。不接受 Base64 輸入，因此請先將本機檔案託管至可存取的位置。 - 查看價格：透過 MCP 呼叫
get_pricing，可在提交任何任務前取得模型目前以美元計價的費率。 - 提交並等待：先呼叫
submit_task，再呼叫get_task並傳入wait_seconds: 50，直到任務完成。使用 HTTP 時，向模型端點提交請求，然後約每三秒輪詢一次GET /v1/tasks/{id}。
失敗的任務不計費。提交操作不具冪等性：重試未收到回應的請求，會再建立一個任務並再次扣款，因此請先檢查你的任務歷史或餘額。
需要考量的限制
| 限制 | 預設值 | 超過限制時的回應 |
|---|---|---|
| 每個帳號同時執行的影像與影片任務數 | 50 | HTTP 429，錯誤碼 30002 |
請求也可能因短時間內過多而受到流量限制，同樣會回傳 HTTP 429。遇到 HTTP 429 時，如果有 Retry-After，請依其指定的時間等待；否則採用指數退避，在每次重試時延長等待時間、加入隨機抖動，並設定最長等待時間。請依據狀態碼做出判斷，而非解析錯誤回應本文，因為文字端點會使用各自協定的錯誤格式。批次作業應維護一個佇列，在執行中的任務完成後再提交新任務，而非一次全部傳送。如需提高限額，請聯絡 [email protected]。
機器可讀的入口
| URL | 說明 |
|---|---|
/llms.txt | 供語言模型使用的模型、文件與指南索引 |
/models/<slug>/llms.txt | 單一模型的參數、價格與範例 |
/docs/<page>.md | 任意文件頁的 Markdown 版本，例如 /docs/api/overview.md |
/.well-known/agent-skills/index.json | 代理技能索引 |
/.well-known/api-catalog | API 目錄（RFC 9727） |
https://api.seedrouter.ai/v1/mcp | MCP 伺服器 |