NsfwAiApi/指南
SillyTavern OpenAI 相容 API:逐步設定指南
SillyTavern OpenAI 相容 API 連接透過其自訂 Chat Completion 來源運作。本頁顯示需要填寫的欄位、此服務應使用的值,以及角色扮演時值得調整的設定。


開始之前
你需要三樣東西:已安裝並運行的 SillyTavern、API 金鑰,以及端點詳細資訊。對於金鑰,請透過 Google 或電子郵件在 API 金鑰頁面 註冊,然後一鍵領取 $0.50 的試用額度。無需付款方式,有效期為 7 天。完整儲值以加密貨幣支付(TRC20 上的 USDT 或 Base 上的 USDC),起付金額為 $20。
你需要貼上的值:
| 欄位 | 說明 |
|---|---|
| Base URL | https://api.nsfwaiapi.com/v1 |
| 模型 ID | uncensored |
| 驗證 | 作為 API 金鑰發送的 Bearer 金鑰 |
不要在 Base URL 中添加 /chat/completions。SillyTavern 應用程式會自行附加路徑。
該模型經過調整,可針對合法成人用途不拒絕內容。涉及未成年人的性內容一律禁止,因此請將角色設定限定為成人。
在應用程式外驗證金鑰
兩分鐘的測試可以省去很多猜測。如果 curl 正常運作,之後的任何失敗都是 SillyTavern 的設定問題,而非你的金鑰問題。
curl https://api.nsfwaiapi.com/v1/models \
-H "Authorization: Bearer YOUR_KEY"包含 uncensored 的 JSON 列表表示金鑰和 URL 正確。然後嘗試實際的完成請求:
curl https://api.nsfwaiapi.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Say hi in five words."}]}'包含 choices 陣列的回覆確認生成正常運作。X-Balance-USD 回應標頭顯示你的剩餘額度。更多端點詳細資訊請參見 文件。
逐步連線 SillyTavern
- 開啟頂部列的插頭圖示(API 連接)。
- 將 API 類型設定為 聊天補全。
- 在來源下拉選單中,選擇 Custom (OpenAI-compatible)。
- 在自訂端點欄位中,貼上
https://api.nsfwaiapi.com/v1。 - 將您的金鑰貼到 API 金鑰欄位並儲存。
- 在模型 ID 欄位中輸入
uncensored。如果應用程式在連接後提供模型列表,請選擇相同的名稱。 - 按下連接。綠色狀態列表示應用程式已連接到端點。
SillyTavern 各版本之間的選單標籤會有些微變動,因此如果欄位名稱不同,請尋找包含端點 URL 的那一個。每個版本的邏輯相同:應用程式會將標準 OpenAI 格式的請求發送給你提供的 URL。
上下文大小與回應長度
此模型擁有 100,000 token 的上下文視窗,由提示詞與回覆共用。SillyTavern 每次都會發送你的角色設定、世界資訊、聊天歷史與系統提示詞,你可以透過上下文大小滑桿決定要包含多少歷史內容。
越大並不一定越好。輸入按每 100 萬 token 收取 $0.15,因此一個佔用 32,000 token 上下文視窗的請求,在回覆前的成本為 32,000 / 1,000,000 x $0.15 = $0.0048。若達到 100,000 token,每次請求成本為 $0.015。在 200 則訊息的晚上,相對於 $20 的額度,這差距是實質的金錢:200 x $0.0048 = $0.96 對比 200 x $0.015 = $3.00 僅輸入成本,假設從第一則訊息開始上下文就滿了,這會高估成本。
實用的起始設定是 16,000 到 32,000 token 的上下文視窗,以及 300 到 500 token 的回覆長度。僅在角色遺忘重要事項時才提高上下文視窗。角色扮演模型指南詳細說明了長上下文視窗如何影響場景。
建議嘗試的取樣器設定
使用聊天補全來源時,SillyTavern 會發送 API 接受的取樣器數值。此服務會透傳 temperature、top_p、stop、seed 以及頻率與存在懲罰值。
- Temperature: 創意場景設為 0.85 到 1.0,如果角色偏離主題則設為 0.6 到 0.7。
- Top P: 0.9 到 0.95。
- 頻率懲罰和存在懲罰: 設為 0.2 到 0.5 以減少長對話中的重複用詞。
- 串流輸出:開啟它。回覆逐字出現且感覺更快。串流中的請求會佔用一個並行請求槽位,直到串流結束為止,這在你同時執行多個對話時才有意義。
屬於其他後端的設定(例如來自本地引擎的 top_k、min_p 或重複懲罰)可能會被忽略。如果滑桿沒有可見效果,不要在此花費時間。
修復常見錯誤
401 或身份驗證失敗
金鑰貼上時帶有空白或值錯誤。請再次貼上並按下儲存,然後再連線。
404 或模型錯誤
確認基礎 URL 以 /v1 結尾,且模型 ID 恰好為 uncensored,為小寫。
429 且代碼為 rate_limited 或 concurrency
完整金鑰每分鐘可發 300 個請求,同時最多 8 個;試用金鑰每分鐘 60 個請求,同時最多 2 個。如果你有開啟多個分頁或群組聊天同時產生,可能會觸發並行上限。請稍候並重試。若收到帶有 Retry-After: 5 標頭的 429 錯誤,代表暫時過載,因此等待五秒鐘是正確的處理方式。
回覆在句子中間被截斷
在 SillyTavern 中增加回應長度。API 本身允許完成請求使用視窗的剩餘部分。
餘額耗盡
失敗或拒絕的請求不會收費,但成功的請求會。請查看 定價 以了解儲值金額和獎金。
提示詞、預設值與群組聊天
聊天完成模式根據提示詞區塊列表建構每個請求:主提示詞、角色描述、場景、範例對話、世界資訊和對話歷史。你可以在提示詞管理器中重新排序或關閉它們。兩個習慣會帶來好處。
- 保持主提示詞簡短。 幾行關於語氣、長度和模型永遠不寫用戶行的規則。長篇重複的指示會在每輪消耗輸入 token。
- 修剪範例對話。 模型會複製它看到的長度和風格。兩個短範例勝過六個長範例。
群組聊天為每個發言的角色發送一個請求。對於限制為 2 個並行請求的試用金鑰,四個同時生成的群組可能會觸發 concurrency 429。將群組設定為一次生成一個回覆,或升級到具有 8 個並行槽位的完整金鑰。
切換角色時請記住,聊天歷史每次都會重新發送。新對話從少量上下文與低廉費用開始,因此請為新場景開啟全新對話,而不是拖著 60,000 token 的歷史記錄繼續。
一次對話的成本
假設一個晚上有 100 則訊息。若平均請求攜帶 12,000 token 的輸入並返回 350 token。輸入:100 x 12,000 = 1,200,000 token,即 1.2 x $0.15 = $0.18。輸出:100 x 350 = 35,000 token,即 0.035 x $0.50 = $0.0175。總計整個晚上約為 $0.20。
額度永不過期且無訂閱,因此 $20 的儲值在該費率下可覆蓋約 100 個晚上。較大儲值享有獎金:$50 起 +5%,$100 起 +10%,$200 起 +15%。數字會隨你的上下文大小而變化,這是你可以控制的主要變量。
更多指南
問答
我在 SillyTavern 中應該選擇哪個來源?
聊天完成,然後選擇自訂(OpenAI 相容)來源。輸入基礎 URL、你的金鑰以及模型 ID uncensored。
我需要在 URL 中添加 /chat/completions 嗎?
否。使用以 /v1 結尾的基礎 URL,並讓 SillyTavern 自行新增路徑。
上下文視窗應設定為多少?
從 16,000 到 32,000 個 token 開始。上下文視窗為 100,000,但若每輪都填滿會增加輸入成本。
可以使用免費試用額度嗎?
可以。新用戶在註冊後可一鍵領取 $0.50 的試用額度。有效期為 7 天,且速率限制較低。