SillyTavern 整合指南
透過 Custom OpenAI-compatible 聊天補全來源將 UnoRouter 連接到 SillyTavern。
SillyTavern 是一款自架式的角色扮演與角色聊天前端,專為大型語言模型設計。它在本機執行,將角色與對話儲存在你自己的電腦上,並支援任何 OpenAI 相容 API 作為聊天補全來源。
概觀
SillyTavern 透過 Chat Completion 來源與 UnoRouter 通訊。你只需貼上基礎 URL 與 API 金鑰,並從自動填入的下拉式選單挑選模型即可。不需要代理伺服器、反向通道或任何額外設定。
快速設定
將以下三個值複製到 SillyTavern 的 Custom(OpenAI-compatible)來源欄位。
基礎 URL: https://api.unorouter.ai/v1
API 金鑰: YOUR_API_KEY
模型: claude-opus-4-5只需貼上基礎 URL。SillyTavern 會自動附加 `/chat/completions`,如果你自己加上反而會造成 400 錯誤。
逐步設定
- 1開啟 AI Response Configuration
在 SillyTavern 中,點選頂部的插頭圖示以開啟 API Connections 面板。
- 2選擇 Chat Completion
將 API 類型設為 Chat Completion。
- 3選擇 Custom(OpenAI-compatible)
在 Chat Completion Source 下拉式選單中,選擇 Custom(OpenAI-compatible)。
- 4貼上基礎 URL
輸入 UnoRouter 以 `/v1` 結尾的基礎 URL。請勿加上 `/chat/completions`。
- 5貼上 API 金鑰
將你的 UnoRouter API 金鑰貼到 Custom API Key 欄位。
- 6連線並挑選模型
點選 Connect。Model 下拉式選單會自動從 UnoRouter 的模型列表載入,挑選你想要的即可。
- 7選用:略過狀態檢查
如果訊息明明已正常送出,SillyTavern 卻仍顯示警告橫幅,請啟用 Bypass API Status Check。
模型下拉式選單的行為
SillyTavern 會呼叫你基礎 URL 上的 `GET /v1/models` 來填入模型選擇器。UnoRouter 有提供此端點,因此下拉式選單會自動填入。若始終為空,請改用 Custom Model ID 文字欄位手動輸入模型名稱。
疑難排解
- 每則訊息都回傳 400 Bad Request。 你在 URL 後面附加了 `/chat/completions`。請移除它,基礎 URL 必須以 `/v1` 結尾。
- 模型下拉式選單是空的。 連線失敗。請重新檢查基礎 URL,然後切換 Bypass API Status Check,讓 SillyTavern 停止提前中斷模型清單。
- 401 Unauthorized。 API 金鑰已過期或輸入錯誤。請在 UnoRouter 控制台產生新金鑰,貼上時確保前後沒有空白字元。
- 429 Too Many Requests。 你已達到目前方案的速率限制。請稍候一分鐘,或在 UnoRouter 帳單頁面升級方案。
- SSL 或憑證錯誤。 你的系統時間不正確。請同步時間後再試,SillyTavern 使用系統的信任憑證庫。
- 串流輸出在句子中途中斷。 先在產生設定中關閉 Streaming,確認問題是否出在串流端,再重新啟用。企業代理若去除 `data:` 前綴也可能導致此問題。
準備好開始聊天了嗎?
取得你的 UnoRouter API 金鑰,開始搭配我們支援的每個模型使用 SillyTavern。