如何在 SillyTavern 串接 TavernAPI
要在 SillyTavern 串接 TavernAPI，請打開頂端的 API Connections 面板，選擇 Chat Completion → Custom (OpenAI-compatible)，貼上 https://tavernapi.com/v1 與你的 API 金鑰，按下 Connect 連線並選擇模型 ID；若想套用我們的寫作規則，再匯入預設 JSON 檔即可。
https://tavernapi.com/v1 sk-tav-... -
步驟 1：在 TavernAPI 控制台建立 API 金鑰
使用電子郵件、Google 或 Discord 登入 TavernAPI 控制台。完成信箱驗證即可領取 $0.30 免費試用額度（可用於 Gemini 4 Argon 與 Gemini 3.8 Flash），接著點選左側的「API keys」分頁並按下「Create API key」。請立刻複製產生出來的
sk-tav-...金鑰——完整金鑰只會顯示這一次。 -
步驟 2：將 SillyTavern 設為 Custom (OpenAI-compatible)
打開 SillyTavern，點選畫面頂端的 API Connections 圖示（插頭圖示），依序填入以下欄位：
- API: Chat Completion
- Chat Completion Source: Custom (OpenAI-compatible)
- Custom Endpoint (Base URL): https://tavernapi.com/v1
- Custom API Key: 貼上你的
sk-tav-...金鑰
-
步驟 3：點選 Connect 並選擇模型 ID
按下 Connect，SillyTavern 會自動拉取可用模型列表。打開 Available Models 下拉選單，挑選標準模型 ID：gemini-4-argon（絕大多數玩家的首選推薦）、claude-opus-5.5（最強劇情邏輯與設定貼合度）、gemini-3.8-flash、deepseek-v4-pro 或 claude-sonnet-5.5。
-
步驟 4：匯入 TavernAPI 專用預設（或使用你自己的預設）
若要使用我們的伺服器鎖定角色扮演預設，請先從 TavernAPI 控制台的 Presets 分頁下載預設 JSON 檔，接著打開 SillyTavern 最左側的 AI Response Configuration 面板（滑桿圖示），點選 Import preset 匯入。你可以在本地自由開關或修改明文規則（字數、輸出語言、防搶話），而鎖定的核心條目（[[tav:pack/block]]）會在我們的伺服器上自動展開。習慣用自己本地的預設嗎？直接保持選用你自己的預設即可——不帶預設的直連請求同樣享有自動提示詞快取。
常見錯誤碼排解
未填寫 API 金鑰、貼錯字元，或該金鑰已被撤銷。
請確認 Custom API Key 欄位已貼上完整的 sk-tav-... 金鑰且前後沒有多餘空白，或到控制台重新建立一組新金鑰。
帳號目前餘額低於該次請求的預估最高費用。
請至控制台儲值餘額、購買 30 天額度包或兌換儲值碼；若你在 SillyTavern 把 Max Response Length（max_tokens）調得異常高，將它調降也能減少預扣金額。
你可能正以免費試用額度呼叫非試用模型（試用僅開放 gemini-4-argon 與 gemini-3.8-flash），或是你的 SillyTavern 預設裡包含了帳號尚未解鎖的 [[tav:pack/block]] 預設包。
使用試用額度時，請改選 gemini-4-argon 或 gemini-3.8-flash 並關閉付費預設包。若要解鎖標準版預設請儲值滿 $5+；若要解鎖專業版預設，可花 $4.99 單獨購買、啟用 $19/$39 額度包，或累計消費滿 $25。
請求發送過於頻繁，或上游線路在開始串流輸出前暫時滿載。
請稍等幾秒鐘再滑動重骰（重新生成）。只要上游請求在開始傳回回覆前失敗，系統就絕不會扣款。