搜尋文件...

開始輸入以搜尋文件

SillyTavern

SillyTavern 整合指南

透過 Custom OpenAI-compatible 聊天補全來源將 UnoRouter 連接到 SillyTavern。

什麼是 SillyTavern?

SillyTavern 是一款自架式的角色扮演與角色聊天前端,專為大型語言模型設計。它在本機執行,將角色與對話儲存在你自己的電腦上,並支援任何 OpenAI 相容 API 作為聊天補全來源。

概觀

SillyTavern 透過 Chat Completion 來源與 UnoRouter 通訊。你只需貼上基礎 URL 與 API 金鑰,並從自動填入的下拉式選單挑選模型即可。不需要代理伺服器、反向通道或任何額外設定。

快速設定

將以下三個值複製到 SillyTavern 的 Custom(OpenAI-compatible)來源欄位。

text
基礎 URL: https://api.unorouter.ai/v1
API 金鑰:  YOUR_API_KEY
模型:    claude-opus-4-5

登入以自動填入 API 金鑰

只需貼上基礎 URL。SillyTavern 會自動附加 `/chat/completions`,如果你自己加上反而會造成 400 錯誤。

逐步設定

  1. 1
    開啟 AI Response Configuration

    在 SillyTavern 中,點選頂部的插頭圖示以開啟 API Connections 面板。

  2. 2
    選擇 Chat Completion

    將 API 類型設為 Chat Completion。

  3. 3
    選擇 Custom(OpenAI-compatible)

    在 Chat Completion Source 下拉式選單中,選擇 Custom(OpenAI-compatible)。

  4. 4
    貼上基礎 URL

    輸入 UnoRouter 以 `/v1` 結尾的基礎 URL。請勿加上 `/chat/completions`。

  5. 5
    貼上 API 金鑰

    將你的 UnoRouter API 金鑰貼到 Custom API Key 欄位。

  6. 6
    連線並挑選模型

    點選 Connect。Model 下拉式選單會自動從 UnoRouter 的模型列表載入,挑選你想要的即可。

  7. 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。