純翻譯服務商
什麼是純翻譯服務商、陪讀蛙支援哪些、各自需要填什麼，以及什麼時候該用它而不是 LLM 服務商。
什麼是純翻譯服務商
純翻譯服務商只做一件事：你把文字送過去，它把譯文送回來。沒有模型可選，沒有提示詞可寫，也沒有對話。在 設定 → API 服務商 → 新增服務商 中，陪讀蛙把它們歸在 純翻譯服務商 分組下。
LLM 服務商是靠「被要求翻譯」來翻譯的。多出來的這一步才讓頁面上下文、你自己的提示詞寫法和術語庫成為可能——同時也是它更費 token、通常也更慢的原因。
它們做不到什麼
純翻譯服務商可以指派給網頁翻譯、影片字幕、選取文字翻譯和輸入框翻譯，但承載不了任何依賴提示詞的能力：
- AI 智慧上下文 沒有提示詞可以補充，所以這個開關對它們不起作用。
- 個人化翻譯提示詞 在所選服務商不是 LLM 時會在彈出視窗裡變灰。
- 自訂 AI 指令 和筆記建議只接受 LLM 服務商。
- 字幕 AI 分段 會被跳過，字幕按到達的原始句段逐條翻譯。
- 術語庫會被忽略。 術語是隨系統提示詞一起送出的，所以只對 LLM 翻譯生效。
如果術語庫在某個頁面上突然不生效了，先看這個功能用的是哪個服務商。每個功能各自選擇服務商，網頁翻譯可能已經切到 DeepL，而選取文字翻譯還留在 LLM 上。
這個分組裡有哪些服務商
DeepL
DeepL 官方 API。只需要填 API Key，沒有 Base URL 欄位——陪讀蛙會根據金鑰的格式自動選擇 Free 或 Pro 端點。詳情和語言代碼處理見 DeepL。
DeepLX
非官方的 DeepL 相容 API。必須填 Base URL，API Key 只在你的實例需要時才填，所以用免費公共實例時金鑰可以留空。如果你的服務要求把 token 放在路徑以外的位置，Base URL 裡可以使用 {{apiKey}} 佔位符。詳見 DeepLX。
Google Translate 與 Microsoft Translator
它們屬於同一類，但完全不需要設定：預設就已新增並啟用，沒有憑證要填，也無法刪除。也正因為如此，你在 新增服務商 對話框裡找不到它們。
Microsoft Translator 不能與「僅譯文」頁面模式搭配使用。它的介面不保留標籤結構，因此陪讀蛙會直接阻止這個組合，而不是讓它把頁面弄壞。
新增並啟用
只新增但沒有啟用的服務商不會出現在功能選擇器裡。在服務商編輯器裡直接把它指派給某個功能時，陪讀蛙會順手替你啟用它。
測試連線
測試連線 不是簡單的連通性檢查——它會用你目前的真實設定翻譯單字 Hi，所以綠色勾號意味著這套設定確實產出了譯文。
- 綠色勾號表示成功；沙漏表示成功了，但耗時超過三秒。
- 紅色叉表示請求失敗。按鈕上不會顯示原因，可以在真實頁面上翻譯一次來看具體報錯。
- API Key 為空時按鈕不可點選，DeepLX 例外，因為它允許無金鑰執行。
- 結果會在幾秒後消失，並且你一改動服務商、金鑰或 URL 就會立即重設——這樣舊的勾號不會為你已經改過的設定背書。
什麼時候該選它
適合選純翻譯服務商的情況：
- 你要翻譯長頁面或整條字幕軌，希望單次請求的延遲最低。
- 你想要可預測的成本。DeepL 按字元計費而非 token，免費 DeepL 金鑰或公共 DeepLX 實例則是零成本。
- 你的 LLM 額度緊張，更願意把它花在自訂 AI 指令上，而不是批次網頁翻譯上。
建議繼續用 LLM 服務商的情況：
- 你依賴術語庫、個人化提示詞或 AI 智慧上下文。
- 文字需要的是判斷力而不是字面準確——慣用語、玩笑、領域術語。
- 你希望一個服務商同時承擔翻譯和 AI 功能，而不想維護兩套設定。
一個不錯的折衷是：網頁翻譯用純翻譯服務商，選取工具列留在 LLM 上。這樣高頻路徑便宜，而你停下來細看的那些詞仍然有更講究的譯法。
常見問題排解
“DeepL API key is not configured”
API Key 欄位為空。DeepL 沒有無金鑰模式。
“DeepL translation request failed” 或 “DeepLX translation request failed”
服務商回傳了錯誤狀態。陪讀蛙會把狀態碼和服務商自己的錯誤內容附在這條訊息後面，通常這就是最值得先讀的資訊。常見原因是金鑰無效或過期、金鑰類型與方案不符、字元額度已用盡。
“API key is required when using {{apiKey}} placeholder in DeepLX baseURL”
Base URL 裡寫了佔位符，但 API Key 為空。要麼填上金鑰，要麼把佔位符從 URL 裡去掉。
“Unexpected response format from DeepLX translation API”
請求成功了，但回傳的內容不是 DeepLX 實例該有的格式。陪讀蛙期望一個 JSON 回應，譯文放在 data 字串欄位裡。被改造過用途或加了登入頁的公共實例經常在這裡失敗。
“Network error during DeepL/DeepLX translation”
請求根本沒到伺服器：實例離線、網域解析不了，或者它的 CORS 標頭拒絕了擴充功能。自架實例必須能被瀏覽器存取，而不只是能在你的終端機裡存取。
譯文沒問題，但術語譯錯了
在這類服務商上這是預期行為——見上面的「它們做不到什麼」。如果術語比速度更重要，把這個功能換到 LLM 服務商。
相關頁面
設定服務商與 API Key · DeepL · DeepLX · 內建服務商設定 · OpenAI 相容自訂服務商