SillyTavern API 設定:OpenAI 相容連接步驟
說明 sillytavern api 設定中容易混淆的連接目標、金鑰、模型名稱與上下文數值,並附上用於確認的指令。
更新日期
重點
- 連接方式選擇 Chat Completion 的自訂(OpenAI 相容)
- URL 為 https://api.mukenetsuapi.com/v1,模型名稱為 uncensored
- 上下文視窗可達 100,000,但考量費用與速度,建議適度縮減。
- 401 檢查金鑰,404 檢查 URL,429 檢查是否超過並行請求或速率限制

準備好所需的 3 項內容
sillytavern API 設定本身步驟簡短,多數卡關點在於輸入值錯誤。請先準備好以下 3 項。
- API 金鑰:於 API 金鑰取得頁面 發行。註冊後可一鍵獲得 $0.50 的試用額度。
- Base URL:
https://api.mukenetsuapi.com/v1 - 模型名稱:
uncensored
SillyTavern 是一個可新增 OpenAI 相容端點的前端介面。由於此 API 為 OpenAI 相容,因此無需選擇官方 OpenAI,可將其註冊為自訂端點。
連接步驟
選單文字可能因版本而異。此處僅描述一般流程,若有所不同,請一併參考 SillyTavern 說明文件。
- 開啟頂部的「API Connections」(插頭圖示)。
- 選擇 API 類型為「Chat Completion」。
- 從來源列表中,選擇 OpenAI 相容的自訂連接(Custom)。
- 在端點 URL 輸入
https://api.mukenetsuapi.com/v1。末尾不需要加上/chat/completions。 - 將發行的金鑰貼入 API 金鑰欄位。請確保前後沒有空白。
- 將模型名稱設為
uncensored。若可從列表選擇則選擇,若需手動輸入則直接輸入。 - 按下連接按鈕,確認是否顯示成功訊息。
連接前,在終端機確認金鑰與 URL 是否正確,有助於排除問題。
curl https://api.mukenetsuapi.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "uncensored", "messages": [{"role": "user", "content": "こんにちは"}], "max_tokens": 50}'若收到回應,表示金鑰、URL 與模型名稱正確。此時若 SillyTavern 仍失敗,則應檢查應用程式端的輸入。
設定上下文與回應長度
此 API 的上下文視窗可容納提示詞與輸出合計 100,000 token。但不建議將 SillyTavern 的上下文視窗設為最大,因為每次都會重新發送角色設定、世界觀與對話歷史,導致每次請求的 token 消耗增加。
費用計算範例
若上下文使用 16,000 token,回應為 300 token,則每則訊息的費用如下:
- 輸入:16,000 ÷ 1,000,000 × $0.15 = $0.0024
- 輸出:300 ÷ 1,000,000 × $0.50 = $0.00015
- 合計:$0.00255
100 則訊息需 $0.255。將上下文視窗縮減至 8,000,輸入端的 token 消耗約為一半。單價詳情請見 費用頁面。
建議值
若非長篇故事或多人場景,建議先從 8,000 至 16,000 開始,若覺得角色遺忘過去事件再調高,此順序較具現實性。回應最大長度請依希望一次讀取的長度設定。max_tokens 為可選參數,若希望避免過長回應,建議在 SillyTavern 端設定上限。
採樣設定概念
temperature、top_p、stop、seed及各種懲罰因子會直接傳遞至 API。可透過 SillyTavern 的預設值進行調整。
- 出現重複語句:稍微提高 frequency 或 presence 的懲罰值。
- 回應過於散漫:降低 temperature。
- 單調:稍微提高 temperature。
- 比較:固定 seed,一次只變更一個值。
預設值的項目名稱會因 SillyTavern 版本而異。若設定未生效,請確認所使用的連線方式是否支援該項目,或查閱 SillyTavern 的文件。
常見錯誤與排除
| 症狀 | 可能原因 | 對策 |
|---|---|---|
| 401 | 金鑰有誤或包含空白 | 重新貼上金鑰,並使用 curl 測試同一支金鑰。 |
| 404 | URL 不正確 | 確認結尾是否為 /v1。 |
| 找不到模型 | 模型名稱拼寫 | 以小寫輸入 uncensored。 |
429(concurrency) | 同時請求過多 | 減少快速連續點擊或群組聊天同時生成。 |
429(rate_limited) | 每分鐘請求次數超限 | 稍候片刻。 |
429(Retry-After: 5 附帶) | 暫時擁塞 | 等待 5 秒後重試。 |
完整金鑰上限為同時8個、每分鐘300次,試用金鑰為同時2個、每分鐘60次。串流輸出會佔用1個並行請求的額度直到結束。若使用試用金鑰執行群組聊天,很快就會耗盡額度。
可透過以下指令確認剩餘餘額。
curl https://api.mukenetsuapi.com/v1/balance \
-H "Authorization: Bearer YOUR_API_KEY"也可從回應標頭 X-Balance-USD 讀取。確認模型列表請使用 GET /v1/models。
curl https://api.mukenetsuapi.com/v1/models \
-H "Authorization: Bearer YOUR_API_KEY"使用注意事項
此 API 僅限文字。若使用 SillyTavern 的圖像生成或語音功能,需要其他服務。內容假設為合法成人用途範圍內的小說、角色扮演、伴侶應用程式等虛構內容。在任何設定下,都不會寫出涉及未成年人的性內容。提示詞不會用於模型訓練。
更詳細的參數請見 文件,付款金額為 $20 至 $500 的整數額,支援 USDT(TRC20)或 USDC(Base)。
其他指南
常見問題
SillyTavern 使用的模型名稱是什麼?
為 uncensored。請以小寫直接輸入。
URL 末尾需要加上 /chat/completions 嗎?
不需要。Base URL 只需到 /v1 為止,剩餘路徑由應用程式端補上。
試用金鑰夠用嗎?
用於連線確認或短對話已足夠。但試用金鑰限制為同時 2、每分鐘 60,且有效期為 7 天,若使用群組聊天請為一般金鑰儲值。
也能生成圖片嗎?
無法。此 API 僅支援文字,不支援圖片、語音或影片生成。
上下文視窗應設為多少?
上限為 100,000 token,但建議先從 8,000 至 16,000 開始測試。數值越大,每次輸入量越多,費用也會越高。
API 金鑰只需透過 1 個表單即可取得
建立帳號、複製金鑰、修改 Base URL。完成這三步即可設定完畢。