MCP 連接指南
透過 MCP 將 AI Agent 連接到 ToAPIs，呼叫 200+ 模型生成圖片與影片。
透過 MCP 將 ToAPIs 連接到你常用的 Agent。以瀏覽器登入授權，不必複製 API Key；Agent 會幫你挑選模型、讀取參數、提交任務並取回結果。
請依帳號與餘額所屬站點選擇位址。下方範例使用國際站；toapis.cn 帳號請將 https://api.toapis.com/mcp 替換為 https://api.toapis.cn/mcp，並使用 toapis.cn 控制台。兩站帳號與餘額不互通。
| 站點 | MCP endpoint |
|---|---|
| 國際站 | https://api.toapis.com/mcp |
| 中國大陸站 | https://api.toapis.cn/mcp |
連接前準備
用戶端須支援遠端 MCP 的 Streamable HTTP 傳輸。ToAPIs skills 可協助選擇模型與撰寫提示詞，屬於選用安裝；npx skills add 指令需要 Node.js，略過 skills 安裝仍可使用 MCP。
瀏覽器授權時，登入對應的 ToAPIs 站點，核對用戶端名稱，選擇 API Key 或新建有額度限制的專用 Key，再點選允許。使用標頭驗證時，先在 API 權杖 頁面建立專用 Key，在本機替換 <API_KEY>。請勿將真實金鑰傳到對話或提交至版本庫。
選擇你的用戶端，幾步完成連接
確認連接成功
開一個新對話，傳送下面這句話。能看到餘額就表示已經連好（查詢免費）。如果提示需要登入、驗證失敗或找不到 ToAPIs 工具，回到上面的步驟檢查設定。
我的 ToAPIs 還剩多少額度？今天花了多少？連接後可以做什麼
用自然語言描述需求，Agent 會選擇模型，依文件準備參數，提交並追蹤任務。
生成圖片
文生圖、參考圖編輯，可指定比例與數量。
用 ToAPIs 生成一張 16:9 的海邊燈塔日出圖生成影片
文生影片、圖生影片，預設推薦 Seedance。
把這張產品圖做成 5 秒的直式宣傳影片使用本機素材
直接提供本機圖片路徑，Agent 上傳後作為參考圖使用。
參考 ./product.png，把產品放到白色背景上Agent 會先讀取模型參數文件，以 create_upload 上傳本機參考素材，再用 get_generation 追蹤生成狀態。任務執行中請等待結果，避免重複提交。若提交回應遺失，重試時應沿用原本的 client_request_id，更換 ID 可能建立新的計費任務。狀態為 unknown 時，先到控制台任務列表核對。請儲存回傳的結果連結，用戶端也可以將結果下載到本機。
可用工具
| 工具 | 用途 |
|---|---|
list_models | 列出目前 Key 可用的圖片與影片模型，包含價格與 docs_available。 |
get_model_docs | 生成前讀取模型參數文件，請選擇 docs_available: true 的模型。 |
generate_image | 生成圖片，依模型計費。 |
generate_video | 生成影片，依模型計費。 |
get_generation | 以 client_request_id 查詢 MCP 生成進度與結果。 |
get_task | 以 task_id 查詢圖片或影片任務。 |
create_upload | 為本機圖片、影片或音訊建立一次性上傳位址。 |
get_balance | 查詢 Key 額度與帳戶餘額。 |
list_tasks | 列出目前 Key 的近期任務。 |
get_usage | 彙總目前 Key 指定期間的扣款，最多 31 天，不扣除退款。 |