UnoRouter：AI API 整合與免費模型串接

UnoRouter 是整合多家供應商模型的 AI API 平台，讓你用同一把 API 金鑰與相容介面呼叫不同模型，也能在網站直接進行角色聊天。對個人開發者與模型愛好者而言，它能減少重複設定；選擇時仍要分清免費路線、付費額度與實際供應商的資料規則。

白話說明：UnoRouter 到底是做什麼的？

可以把它想成 AI 模型的「轉接總機」。你的程式先把問題傳到 UnoRouter，再由它轉給所選模型的可用供應商，最後將回答傳回來。要換模型，通常只需在相容設定中更換完整模型 ID，不必重新串接每一家介面。

它提供的是模型存取與請求路由。內建聊天則適合先體驗角色互動：免費模型已經接好，不用帳號或金鑰就能開始；角色、使用者人設、世界書和匯入角色卡，可用來組織故事素材。文件也涵蓋群組對話、自訂供應商與備份還原。

免費額度與月費：先看懂計費單位

以下為 2026 年 11 月 13 日核實的公開美元價格，不是新臺幣報價；付款方式最低金額、匯率及稅費須以結帳條件為準。

• 模型 ID 結尾為 :free 時只走免費供應商，不扣帳戶餘額。預設每位使用者、每個免費模型每分鐘 1 次請求，還可能遇到上游配額、共用池每日 Token 預算或單次輸入大小限制。
• 公開儲值入口從 1 USD 起。購買餘額不會到期，付費模型按輸入／輸出 Token 或每次呼叫價格扣款。
• Starter 為 20 USD／月，標示每月 40 USD 額度、每週發放 10 USD；Pro 為 50 USD／月，標示每月 100 USD、每週 25 USD；Scale 為 100 USD／月，標示每月 200 USD、每週 50 USD。未用完的週額度不會保留到下一週，不能當成可長期累積的儲值餘額。

訂閱另有免費模型等待時間減免，但不代表上游供應商沒有容量限制。請依實際使用頻率查看目前價格與訂閱條件，不要只比較表面的額度倍數。

如何用 API 金鑰完成第一次串接？

1. 註冊帳號，在 Tokens 頁面建立金鑰；只顯示一次，應立即妥善保存。
2. 在 OpenAI 相容用戶端填入 Base URL https://api.unorouter.com/v1 與金鑰。
3. 從目前模型目錄複製正確 ID。想使用免費路線時，確認包含 :free。
4. 先傳送簡短問題並確認回答。直接呼叫 Chat Completions 時，完整端點為 https://api.unorouter.com/v1/chat/completions。
5. 查看模型的上下文長度、費率及能力標記；免費模型未必支援圖片或工具呼叫。

官方快速入門提供完整設定。金鑰可設定支出上限、到期時間、模型與 IP 允許清單。Claude Code、Gemini CLI 等原生協定工具的網址規則不同，須依個別指南設定。

Janitor AI 代理與站內聊天怎麼選？

Janitor AI 的 Proxy URL 應填完整的 https://api.unorouter.com/v1/chat/completions。在 API Settings 新增設定，填入名稱、完整模型 ID、金鑰及代理網址；儲存設定後，強制重新整理瀏覽器再測試。若用戶端提供自動附加 /chat/completions 的選項，避免重複附加。可依官方 Janitor AI 指南核對欄位。

只想先聊天可使用站內免費模型。聊天記錄存在瀏覽器，清除網站儲存資料可能一併刪除本機記錄；有重要角色或長篇對話時，先了解備份方式。

自動路由與資料處理有哪些限制？

自動路由會選擇當下可用且較便宜的供應商群組，失敗時嘗試切換。固定群組能控制模型使用哪些路線，但也縮小備援範圍。付費模型沒有 UnoRouter 自設的 RPM、TPM 或並行上限，仍受上游容量影響，不能當作永遠不中斷的保證。

本機儲存聊天記錄不代表在本機執行模型。提示詞仍傳給供應商；UnoRouter 表示不使用輸入與回答訓練自己的模型，但其他供應商可能保留資料或用於訓練。隱私政策說明跨境處理與同意要求，自動路由不等於資料只在歐盟處理。

現行服務條款寫明目前未提供商業客戶帳號，生成結果的權利依特定模型條款而定。開放原始碼不能直接推論所有輸出都有統一商用授權，也不代表已驗證臺灣付款或連線可用性。

常見問題

免費模型可以無限使用嗎？

不行。:free 表示該路線不扣餘額，仍有頻率、大小及供應商容量限制；訂閱等待減免也不會解除所有上游限制。

直接聊天需要帳號與 API 金鑰嗎？

站內免費聊天不需要；API 或外部用戶端需要自己的金鑰。免登入聊天不等於匿名 API。

遇到 429 或 503 要怎麼處理？

429 先依 Retry-After 等待。503 須讀取細部錯誤：get_channel_failed 可能是供應商或固定群組不可用，model_not_found 則應修正模型 ID。

聊天記錄存在瀏覽器，資料就不會傳出去嗎？

不是。生成回答仍需傳送輸入。歷史記錄的位置、UnoRouter 的訓練政策，以及供應商自己的資料規則，須分開確認。

官方資源與開發者社群

• 平台文件：金鑰、錯誤碼與帳單。
• 模型服務狀態：查詢即時可用性。
• 官方 GitHub：網關與聊天原始碼，依各儲存庫核對授權。
• 官方 Discord：串接協助與社群更新。