如何在 SillyTavern 中使用 DeepSeek API：自訂端點

五個步驟完成設定

如何使用 DeepSeek API 與 SillyTavern 的問題歸納為一個事實：SillyTavern 可以連接任何 OpenAI 相容的端點，因此你只需提供 URL、金鑰和模型 ID。請注意，此服務並非官方的 DeepSeek API。它託管了一個 ID 為 uncensored 的開放權重模型，由獨立供應商運行，並針對合法成人用途調整為無內容拒絕的回答。

1. 建立帳戶並開啟 API 金鑰頁面。複製金鑰。新用戶可以一鍵領取 $0.50 的免費試用額度，無需信用卡，有效期為 7 天。
2. 在 SillyTavern 中開啟 API 連線標籤頁（頂部列的插頭圖示）。
3. 將 API 類型設為 聊天完成。然後將聊天完成來源設為 自訂（OpenAI 相容）。
4. 在自訂端點欄位輸入 https://api.deepseekapi.top/v1。將金鑰貼上到 API 金鑰欄位。在模型 ID 欄位輸入 uncensored。
5. 按下 Connect。綠色狀態燈和模型名稱表示連線正常。

標籤名稱在 SillyTavern 版本之間會略有變化，但概念保持一致：聊天完成模式、自訂來源、端點、金鑰、模型。從 API 金鑰頁面獲取金鑰。

如果連線失敗

按順序檢查這些項目。大多數失敗是由於其中一項造成的。

• URL 格式錯誤。 端點以 /v1 結尾。不要添加 /chat/completions。
• 來源錯誤。 Text Completion 模式使用不同的請求格式。此 API 提供 POST /v1/chat/completions 和 GET /v1/models，因此請使用 Chat Completion。
• 金鑰貼上時帶有空白。 重新貼上並檢查是否有尾隨空白。
• 伺服器無法存取網路。 如果你在家庭伺服器或容器中運行 SillyTavern，機器需要出站 HTTPS 存取權限。

要區分 SillyTavern 問題和金鑰問題，請從終端機測試金鑰：

Copycurl https://api.deepseekapi.top/v1/models   -H "Authorization: Bearer YOUR_KEY" | grep uncensored

包含 uncensored 的 JSON 列表表示金鑰有效。要檢查聊天路由本身：

Copycurl https://api.deepseekapi.top/v1/chat/completions   -H "Authorization: Bearer YOUR_KEY"   -H "Content-Type: application/json"   -d '{"model": "uncensored", "messages": [{"role": "user", "content": "Say hello in one sentence."}]}'

對角色扮演重要的設定

串流輸出

在 Chat Completion 面板中開啟串流輸出。API 會透過 SSE 發送產生的 token，因此回應會在撰寫時顯示。串流請求會佔用一個並行請求槽位，直到串流結束。完整金鑰允許同時進行 8 個請求，試用金鑰允許 2 個。

上下文大小

該模型具有 100,000-token 的上下文視窗，包含提示詞和完成內容。你不必全部使用。SillyTavern 會在每條訊息中發送角色卡、人格設定、lorebook 條目以及符合你設定限制的盡可能多的聊天歷史記錄。較小的限制意味著較低的帳單和更快的回應。對於大多數對話，16k 到 32k token 已足夠。

最大回覆長度

將回應限制設為合理的數值，例如 400 到 600 token，以防止回應變成一篇長文。API 不需要 max_tokens，但限制可以保護你的預付額度免受失控輸出的影響。

採樣

Temperature、top_p、stop sequences、seed 和 penalties 會直接傳遞給模型。角色聊天的常見起始點是 temperature 0.8 到 1.0 和 top_p 約 0.9。一次只更改一個值。如果角色重複短語，請稍微提高頻率或存在懲罰，而不是提高 temperature。

Stop sequences

如果模型開始同時撰寫使用者的對話內容，請將使用者名稱後跟冒號作為 stop sequence 加入。這會直接傳遞。

首次使用檢查清單

在載入你喜歡的角色之前，先進行短測試對話，以確保連線健康。

1. 建立空白角色或使用預設助手卡。
2. 發送 「請用 ready 這個詞回覆。」。答案應在一兩秒內返回，並在產生時進行串流輸出。
3. 如果沒有出現任何內容，請開啟 SillyTavern 控制台或網路日誌。401 表示金鑰錯誤，404 表示 URL 或模型 ID 錯誤，429 表示達到速率限制。
4. 檢查餘額。每個回應都包含 X-Balance-USD 標頭，因此你可以驗證每則訊息的額度僅微幅減少。
5. 然後再載入你的真實角色卡和 lorebook。

如果回應為空或在句子中間被截斷，請先查看回應長度設定。限制設得太低會導致回應提前結束，而未完成的句子並非模型故障。

在預設值之間切換

SillyTavern 將取樣預設值與連線設定檔分開。值得為敘事寫作保存一個預設值（具有較高的 temperature），並為短事實回應保存一個預設值（具有較低的 temperature）。切換預設值不會影響端點或金鑰。

角色扮演會話的成本

價格為每 1M 輸入 token $0.15，每 1M 輸出 token $0.50，從預付額度扣除，無訂閱。由於歷史記錄會重新發送，輸入部分是較大的部分。以每條訊息 20,000-token 提示詞和 400-token 回應進行聊天：

• 輸入：20,000 × $0.15 / 1,000,000 = $0.003
• 輸出：400 × $0.50 / 1,000,000 = $0.0002
• 總計：每條訊息 $0.0032

因此 100 條訊息的成本為 $0.32。現在比較將上下文截斷為 8,000 token、回應相同的情況：8,000 × $0.15 / 1,000,000 = $0.0012，加上 $0.0002，每條訊息為 $0.0014，100 條為 $0.14。在相同回合數下，減少上下文後成本少於一半。

$0.50 的試用額度約可覆蓋較大尺寸下的 156 條訊息（0.50 / 0.0032 = 156.25）或較小尺寸下的約 357 條（0.50 / 0.0014 = 357.1）。失敗或拒絕的請求不會收費，且額度永不過期。請參閱 定價頁面 以獲取儲值金額、獎金和付款方式；接受信用卡（Visa、Mastercard、Apple Pay、Google Pay）和加密貨幣（TRC20 上的 USDT、Base 上的 USDC）。

角色、安全性與一條硬性規則

該模型針對成人小說、角色扮演和伴侶應用程式進行調整。它不是通用的安全過濾器，也不決定什麼適合你。這是你的工作：將你的卡片和對話保持在合法成人使用範圍內。

唯一的固定限制是禁止涉及未成年人的性內容，且沒有任何提示詞可以改變這一點。請確保你的卡片中角色年齡明確為成人。

一些實用習慣有助於提升聊天品質：

• 將角色的關鍵資訊放在卡片頂部，不要藏在最後。
• 使用簡短的系統提示詞來設定敘述者風格與回覆長度。
• 使用 SillyTavern 的摘要功能來總結對話的舊部分，而不是無限期地保留它們。
• 保持設定集條目簡短並由關鍵字觸發，以便僅在需要時才加入提示詞。

提示詞不會用於訓練。請閱讀 快速入門文件以了解回應標頭，包括 X-Balance-USD，它會顯示你的剩餘額度。

將角色用作伴侶應用程式後端

有些人將 SillyTavern 用作成人長期陪伴角色的前端。適用於任何對話的規則同樣適用。透過將人格寫成一段固定的短區塊來保持一致性，並讓摘要功能處理較舊的事件。會話之間的長時間間隙不會產生費用，因為額度永不過期且沒有訂閱制。

如果你之後建立自己的應用程式而非使用 SillyTavern，你可以從程式碼呼叫相同的端點。快速入門文件 提供了 curl、Python 和 Node 的範例，使用相同的 Base URL 和模型 ID，因此在 SillyTavern 中有效的提示詞可以直接遷移。

繁忙對話中的速率限制

單一對話很少會觸及限制。群組對話、滑動操作和多個分頁則可能觸及。當超過每分鐘請求限制（試用金鑰為 60，完整金鑰為 300）時，服務會以程式碼 rate_limited 回應 HTTP 429；當太多請求同時進行時（試用為 2，完整為 8），則回應 concurrency。

在短暫過載時，你也會收到帶有 Retry-After: 5 標頭的 429 回應。等待五秒鐘後再發送是正確的處理方式。如果你在試用金鑰上看到這些訊息，請關閉額外的分頁或在開始另一個滑動操作前停止滑動。

更多指南

• 如何在 Cursor 中使用 DeepSeek API：自訂 Base URL 設定
• DeepSeek API Python 範例：聊天、串流輸出、工具
• DeepSeek API 金鑰：無審查 LLM API 存取