SillyTavern(酒館)裡的「反代(Proxy)」是什麼意思?
在 AI 角色扮演社群裡,大家常說的 反代(Proxy,又稱反向代理或 API 中轉站),其實就是一個夾在你的聊天前端(例如 SillyTavern(酒館) 或 JanitorAI)與上游 AI 模型商(如 Anthropic、Google 或 DeepSeek)中間的 API 端點網址。當你按下發送時,前端會把組裝好的提示詞傳到這個網址,由該服務把請求轉發給模型,再將模型的回覆串流傳回你的畫面上。
玩家之所以習慣把幾乎所有第三方 API 網址都統稱為「反代」或「Proxy」,主要是因為軟體介面本身就是這樣命名的:SillyTavern 原生的 Claude 與 Google AI Studio 面板把第三方網址放在 Reverse Proxy(反向代理)欄位下,而 JanitorAI 則把自備 API 的設定放在 Proxy 分頁裡。
但與此同時,只要你在社群論壇或 Discord 群組逛個五分鐘,一定會看到老玩家苦口婆心勸新手「離反代遠一點」。這種警覺完全是有道理的。 在角色扮演圈子裡,「反代(Proxy)」這個詞常被拿來指代匿名貼文網站上到處流傳的免費公益連結——這些端點多半靠外流或盜刷的 API 金鑰運作,不僅會在背景偷偷記錄玩家的私人對話、把昂貴的旗艦模型偷換成廉價小模型,還隨時可能無預警關站消失。
為了釐清觀念,我們必須把「軟體介面上的欄位名稱」跟「背後服務的運作方式」分開來看:
- 免費或共用金鑰反代(Free / Shared-key Proxy): 只給你一串公開網址(或群組裡共用的密碼),沒有透明的計費機制,也找不到明確的營運者,背後通常靠濫用免費試用帳號或外流金鑰來維持。
- 付費 API 反代(又稱 API 閘道器 / API 中轉站): 運作方式就像標準的雲端 API 服務——你登入自己的個人帳號、建立專屬的私人 API 金鑰,並按實際消耗的 Token 數量付費,連線至明確標示的上游模型。
在接下來的教學中,只要是軟體畫面本身出現的欄位名稱(如 Reverse Proxy、Proxy URL),我們會保留 Proxy(反代) 這個詞;而在指稱你所串接的服務本身時,則統稱為 API。
你真正需要的是哪一種 Proxy?
在動手修改任何設定檔之前,請先確認你看的教學文章跟你想找的是同一種東西。在 SillyTavern 說明文件與社群討論串裡,大家會把四種完全不同的工具都叫做「Proxy(代理/反代)」:
| 常見叫法 | 出現在哪裡 | 實際用途是什麼 | 跟 AI 角色扮演聊天需要它嗎? |
|---|---|---|---|
| 1. 模型 API 反代(Custom Endpoint / Reverse Proxy) | SillyTavern 的 API Connections 面板;JanitorAI 的 API Settings → Proxy | 透過 HTTPS 與 API 金鑰,把你的角色扮演提示詞轉發給 AI 模型供應商(Claude、Gemini、DeepSeek)。 | 需要 — 除非你直接申請模型商官方自己的 API 金鑰,或用自己的獨立顯示卡(GPU)跑本地模型。 |
2. 對外網路代理(config.yaml) | SillyTavern 根目錄的 config.yaml 設定檔(HTTP / SOCKS 代理設定) | 讓 SillyTavern 發出的網路請求經過你設備上的網路隧道或類似 VPN 的代理軟體。 | 不需要 — 除非你所在的網路環境會阻擋對外連線,必須透過系統網路代理才能上網。 |
3. 自架網頁反向代理(nginx、Caddy) | Linux VPS 雲端架設與遠端連線教學 | 架在你自己的 SillyTavern 伺服器(localhost:8000)前面,讓你出門在外連回自家酒館時能綁定網域並加上 HTTPS 加密。 | 不需要 — 只有當你想把自架的酒館伺服器公開到公網時才用得到(現在大多數玩家都改用 Tailscale,請參考我們的 酒館安裝教學)。 |
4. 早期本地轉接腳本(simple-proxy-for-tavern) | 2023~2024 年的舊版安裝教學 | 早期在電腦本地另外開視窗執行的腳本,用來在 SillyTavern 還不支援原生格式前轉換 API 格式。 | 不需要 — 在新版 SillyTavern 中早已淘汰,現在酒館本身就能直接連上 OpenAI 相容、Claude 與 Gemini API。 |
提示: 如果你剛裝好 SillyTavern 或剛打開 JanitorAI,只是想串接 Claude、Gemini 或 DeepSeek 來玩角色扮演,你只需要 第 1 種(模型 API 端點)。請不要去動 SillyTavern config.yaml 裡的網路代理設定,也可以直接略過那些教你裝 nginx 或本地轉接腳本的舊教學。
反代網址(Proxy URL)要填在哪裡?
幾乎所有角色扮演軟體都會請你填寫同樣三樣東西——端點網址(Endpoint URL)、API 金鑰(API Key)與模型 ID(Model ID)——但不同軟體對網址路徑結尾的要求並不一樣。以下我們以 TavernAPI 與本站提供的五個模型 ID(claude-opus-5-5、claude-sonnet-5-5、gemini-4-argon、gemini-3.8-flash 與 deepseek-v4-pro)為例,列出各軟體的實際填寫位置。
SillyTavern:Chat Completion → Custom (OpenAI-compatible)
在 SillyTavern 裡,透過 Custom (OpenAI-compatible)(自訂 OpenAI 相容端點)連線是最省事的做法,因為只要填一組網址與金鑰,就能直接從同一個下拉選單自由切換 Claude、Gemini 與 DeepSeek:
- 點選頂端工具列的 API Connections 圖示(電線插頭圖示)。
- 將 API 設為
Chat Completion。 - 將 Chat Completion Source 設為
Custom (OpenAI-compatible)。 - 填入連線欄位:
- Custom Endpoint (Base URL):
https://tavernapi.com/v1 - Custom API Key: 填入你的
sk-tav-...金鑰(可在 使用者控制台 的「API 金鑰」頁面建立;完整金鑰只會顯示一次,建立後請立即複製保存)。
- Custom Endpoint (Base URL):
- 點選 Connect(連線),打開 Available Models(可用模型)下拉選單,然後選擇
gemini-4-argon、claude-opus-5-5、gemini-3.8-flash、deepseek-v4-pro或claude-sonnet-5-5。
請不要在 Custom Endpoint (Base URL) 的結尾加上 /chat/completions——SillyTavern 在發送訊息時會自動幫你補上這段路徑。
SillyTavern:Claude 與 Google AI Studio 的 Reverse Proxy 欄位
如果你手邊使用的是專為 SillyTavern 原生 Claude 或 Google AI Studio 來源設計的本地預設,或是想使用特定來源專屬的介面開關,也可以改用酒館內建的 Reverse Proxy(反向代理)欄位,而不走 Custom (OpenAI-compatible)。
- 打開 API Connections(插頭圖示),將 API 保持為
Chat Completion。 - 將 Chat Completion Source 設為
Claude或Google AI Studio。 - 點選 Reverse Proxy 展開反向代理設定,並根據你選的來源填入對應網址:
- 若選 Claude 來源,請將 Proxy Server URL 設為
https://tavernapi.com/v1 - 若選 Google AI Studio 來源,請將 Proxy Server URL 設為
https://tavernapi.com(結尾不要加/v1,因為 SillyTavern 會自己補上 Google 的版本路徑)
- 若選 Claude 來源,請將 Proxy Server URL 設為
- 在 Proxy Password(代理密碼)欄位貼上你的
sk-tav-...API 金鑰。(SillyTavern 在畫面上把它叫做密碼,但實際上要填的是你的 API 金鑰。) - 點選 Connect(連線),接著在 Claude 下選擇
claude-opus-5-5或claude-sonnet-5-5,或在 Google AI Studio 下選擇gemini-4-argon或gemini-3.8-flash。
想看這兩種連線方式與匯入預設的完整圖文步驟,請參考我們的 SillyTavern 串接教學。如果發送訊息時遇到 402 錯誤,請查看 如何排解 402 Insufficient Balance(餘額不足)。
JanitorAI:API Settings → Proxy
JanitorAI 是自帶內建模型的託管型角色卡網站,但它也允許你透過外部的 OpenAI 相容 API 來轉發對話:
- 在 JanitorAI 打開任一角色的聊天畫面,點選畫面頂端的 API Settings,並切換到 Proxy 分頁。
- 填入三個必填欄位:
- Proxy URL:
https://tavernapi.com/v1/chat/completions - API Key: 你的
sk-tav-...金鑰 - Model: 手動輸入你想使用的完整模型 ID,例如
gemini-4-argon、claude-opus-5-5、gemini-3.8-flash、deepseek-v4-pro或claude-sonnet-5-5。
- Proxy URL:
- 儲存設定,即可開始聊天。
注意: 在 SillyTavern 與 JanitorAI 之間切換時,最常踩到的坑就是網址結尾。SillyTavern 的 Custom 來源只要求填基礎網址(https://tavernapi.com/v1),而 JanitorAI 的 Proxy URL 欄位則要求填入完整的對話補全路徑(https://tavernapi.com/v1/chat/completions)。
RisuAI、Agnaistic 與其他 OpenAI 相容軟體
像 RisuAI 與 Agnaistic (Agnai) 這類角色扮演前端,同樣支援串接任何自訂的 OpenAI 相容端點(想了解各軟體的特色與差異,可參考我們的 AI 角色扮演工具推薦與比較)。
想確認某款軟體要求哪種網址格式,只要看它網址輸入框裡的灰色預設範例文字即可:
- 如果範例結尾是
/v1,請填入https://tavernapi.com/v1。 - 如果範例結尾是
/v1/chat/completions,請填入https://tavernapi.com/v1/chat/completions。
接著貼上你的 sk-tav-... API 金鑰,並填入五個模型 ID 之一(gemini-4-argon、claude-opus-5-5、gemini-3.8-flash、deepseek-v4-pro 或 claude-sonnet-5-5)即可。
為什麼免費反代(Free Proxy)有風險?
執行 Claude 與 Gemini 這類大型語言模型,每一輪對話都在燒真金白銀——尤其在角色扮演中,每次回覆都要把好幾千個 Token 的角色卡設定與歷史對話重新傳送一次。無論是 SillyTavern 官方說明文件還是 Chub 的官方文件,都曾明確警告玩家不要隨便使用來路不明的第三方反代。
當有人發放免費或便宜得不合理的反代連結,背後卻看不出任何正常的商業模式時,你其實正承擔著四個具體風險:
- 外流或被盜的金鑰隨時會無預警斷線: 免費反代幾乎不可能自己掏錢付上游算力費用。實際上,它們的金鑰池往往是從公開程式碼倉庫爬蟲抓來的外流金鑰、用盜刷信用卡開出來的帳號,或是靠大量免洗雲端試用帳號輪替撐起來的。只要上游廠商偵測到異常流量並撤銷金鑰,你的反代就會在劇情聊到一半時瞬間斷線。
- 架站者可以記錄並看光你的私人對話: 你透過反代傳送的每一句訊息,都必須以明文經過對方的伺服器才能轉發給模型。沒有隱私權政策的匿名架站者,可以輕易把你的提示詞、角色卡、玩家人設(Persona)與 IP 位址全部存下來,而你完全無法得知這些紀錄最後會流向哪裡。
- 背後實際跑的模型可能被偷換(掛羊頭賣狗肉): 因為反代伺服器完全掌控對外發出的請求,不老實的營運者可以把標示為 Claude 或 Gemini 旗艦模型的請求,在後台偷偷轉給便宜好幾倍的小型模型。如果某個號稱頂規的模型突然忘記基本場景邏輯,或是寫出乾癟、不斷重複的句子,很可能是該端點在背後偷換了模型。
- 沒有客服、沒有保障,也退不了錢: 非正式的免費反代與所謂「贊助群組」的 Discord 伺服器,只要手上的金鑰貨源斷了,往往一夕之間就會關群跑路。這類服務沒有公開的服務條款、沒有正式客服管道,如果你付錢買了共用帳號名額,對方消失時也完全無法求償退款。
儲值付款前,如何檢查一家反代是否安全?
你不需要懂網路工程,也能分辨出正規的 API 服務與來路不明的野雞站。在掏錢儲值之前,請先用這 7 點檢查清單幫任何一家服務商做個體檢:
- 清楚標明每款模型的官方上游渠道: 值得信賴的服務會明確寫出每個模型背後走的是哪一條官方雲端或 API 渠道(例如 AWS、Google Cloud、Google AI Studio 或 DeepSeek 官方 API),而不是用含糊的「獨家私密線路」帶過。
- 擁有個人專屬金鑰,且公開標註更新日期的計價表: 確認網站有公開透明、標有「最後更新日期」的價格表,並且是針對你個人的 API 金鑰按實際 Token 用量計費(或提供規則清楚的額度包)。
- 公開的隱私權政策明確區分「存什麼」與「不存什麼」: 檢查網站是否有真正的隱私權政策頁面,並明確將計費所需的元資料(Token 數量、模型名稱、時間戳記與費用)與你的私人提示詞內文、角色卡區分開來。
- 公開服務條款,且找得到真人客服: 確認網站有公開的服務條款,並提供不只一種能聯絡到真人的管道(例如電子郵件、Telegram 或 Discord),萬一儲值遇到問題時才找得到人處理。
- 實際收到的回覆品質與所選模型一致: 先拿一張你非常熟悉的角色卡,或是一場複雜的多角色對手戲來測試端點,確認它的文筆風格、推理深度與回覆速度都符合正版模型的表現。
- 價格合理可信,而不是「免費無限暢玩 Claude」: 企業大宗採購折扣與伺服器端提示詞快取(Prompt Caching)確實能合法壓低每百萬 Token 的成本;但任何號稱一口價「免費無限量玩 Claude」的服務,背後一定在你看不見的地方動了手腳。
- 可以先小額試水溫,並核對控制台的用量紀錄: 第一天接觸陌生的服務時,千萬不要一次儲值大筆金額;請先用免費試用額度或最小金額儲值,發送幾輪測試回覆,並進控制台的「用量資訊」核對扣款明細是否與公開的 Token 單價一致。
TavernAPI 的做法與真實限制
為了公平起見,我們直接拿上面同一份 7 點檢查清單來檢視 TavernAPI,並坦白說明我們服務的取捨與限制:
- 明確標示官方上游渠道: 我們只精選五款專為角色扮演挑選、全面支援 1M(100 萬)上下文的模型(可參考我們的 5 款模型實測評比與排名)。其中
claude-opus-5-5與claude-sonnet-5-5經由 AWS 與 Google Cloud 提供,gemini-4-argon與gemini-3.8-flash經由 Google AI Studio 提供,而deepseek-v4-pro則直連 DeepSeek 官方 API。 - 公開標註日期的美金 Token 計價: 所有模型的輸入、輸出與快取費率,皆以「每百萬 Tokens 美金(USD)單價」公開列在我們的 模型與價格頁面。我們也會在伺服器端為每一筆連線自動啟用 提示詞快取(Prompt Caching),大幅降低長篇對話的輸入成本,並在 使用者控制台 的「用量資訊」直接顯示快取幫你省下的確切美金金額。
- 絕不儲存對話內容: 正如我們的 隱私權政策 所述,TavernAPI 不會儲存你的訊息內容、角色卡、世界書(Lorebook)或 AI 回覆。為了計費,我們僅記錄 Token 數量、請求時間、模型 ID 與費用。
- 找得到人的客服與清楚條款: 我們公開完整的 服務條款,並在 聯絡我們頁面 提供 Telegram、Discord 與電子郵件等直接聯繫客服的管道。
- 先免費實測再決定是否付費: 新帳號註冊即可領取 $0.30 免費試用額度,可用於測試
gemini-4-argon與gemini-3.8-flash,讓你在花任何一毛錢之前,先親自驗證模型品質並到 控制台 查看逐筆請求的 Token 紀錄。針對 SillyTavern 玩家,我們還提供選配的 角色扮演專用預設,結合本地自訂開關與伺服器自動展開的核心寫作指令。
我們的真實限制: 在用完 $0.30 的免費試用額度後,TavernAPI 就不再是免費服務了。此外,因為每一筆請求都走官方上游供應商,上游原廠自身的安全過濾機制依然存在(不過我們絕不會只因為上游模型拒絕回答某句提示詞,就封鎖你的帳號)。最後,我們只提供上面列出的五款 Claude、Gemini 與 DeepSeek 模型——如果你想要的是 OpenAI 的 GPT 模型,或是幾十種小型開源微調模型,那麼其他綜合型閘道器會更適合你。