DeepLX

陪讀蛙是一個開源的瀏覽器擴充功能：網頁與 YouTube、X 影片雙語對照翻譯，單字和句子一鍵存成閃卡複習。先裝好擴充功能，再照下面的步驟設定。

安裝到 Chrome

什麼是 DeepLX？

DeepLX 是一個免費的非官方 API，透過逆向工程提供接近 DeepL 的翻譯品質。對於需要高品質翻譯、又不想付費使用官方 DeepL API 的開發者，它是一個替代方案。

靈活的 BaseURL 設定

陪讀蛙支援靈活的 DeepLX baseURL 設定，可以搭配不同的 DeepLX 提供者。您可以自訂 baseURL，以符合提供者特定的端點格式。

令牌佔位符支援

您可以在 baseURL 中使用 {{apiKey}} 佔位符，把 API 令牌插入到任何位置。當不同的 DeepLX 提供者要求令牌出現在不同的 URL 格式中時，這會很有用。

範例：

1. 路徑中的令牌: https://api.deeplx.com/{{apiKey}}/translate
2. 作為查詢參數的令牌: https://api.deeplx.com/v1/translate?token={{apiKey}}
3. 子網域中的令牌: https://{{apiKey}}.api.deeplx.com/translate

Base URL 依原樣使用

除了填入 {{apiKey}} 之外，陪讀蛙會依您填寫的 Base URL 原樣送出請求，不會自動補上 /translate，也不會替您插入令牌。因此請填寫提供者的完整端點位址，通常以 /translate 結尾。預設值是 https://api.deeplx.org/{{apiKey}}/translate。

如果提供者需要令牌，請把 {{apiKey}} 放在令牌該在的位置。API Key 只用來填入這個佔位符。

設定範例

不需要 API 令牌

有些 DeepLX 提供者不需要身分驗證：

BaseURL: https://deeplx.vercel.app/translate
API Key: （留空）
結果: https://deeplx.vercel.app/translate

路徑中的令牌

BaseURL: https://api.deeplx.com/{{apiKey}}/translate
API Key: your-secret-token
結果: https://api.deeplx.com/your-secret-token/translate

作為查詢參數的令牌

BaseURL: https://api.example.com/v1/translate?key={{apiKey}}
API Key: your-api-key
結果: https://api.example.com/v1/translate?key=your-api-key

帶有令牌的自訂端點

BaseURL: https://deeplx.mydomain.com/api/{{apiKey}}/translate
API Key: abc123
結果: https://deeplx.mydomain.com/api/abc123/translate

在陪讀蛙設定 DeepLX

1. 開啟擴充選項: 點擊陪讀蛙擴充圖示並進入選項頁面
2. 導覽至 API 提供者: 進入 API 提供者部分
3. 設定 DeepLX:
   • 把 Base URL 設為提供者的完整端點位址，包含 /translate
   • 如果提供者需要令牌，在 Base URL 中令牌該在的位置寫上 {{apiKey}}，並把令牌填到 API Key
   • 不需要金鑰的提供者，API Key 留空即可
4. 測試翻譯: 嘗試翻譯一些文字以確認設定是否正常運作

常見的 DeepLX 供應商

免費提供者（不需要 API 金鑰）

• https://deeplx.vercel.app/translate
• https://deeplx.herokuapp.com/translate

付費/自架提供者

• https://api.deeplx.org/{{apiKey}}/translate（需 API 金鑰，這是預設值）
• 您自己的自託管實例

故障排除

URL 建構問題

如果您在 URL 建構方面遇到問題：

1. 確認 Base URL 是完整的端點位址: 陪讀蛙不會自動補上 /translate，Base URL 裡必須包含它
2. 驗證令牌位置: 確保 {{apiKey}} 在正確的位置
3. 先不用令牌測試: 嘗試使用免費提供者來隔離設定問題

常見錯誤

• "使用 {{apiKey}} 佔位符時需要 API 密鑰": 您在 baseURL 中指定了 {{apiKey}} 但沒有提供 API 密鑰
• "DeepLX 翻譯請求失敗": 檢查您的 baseURL 和 API 金鑰是否正確
• 網路錯誤: 驗證 DeepLX 提供者是否可存取且在線

API 回應格式

DeepLX 提供者應該傳回下列格式的 JSON 回應：

{
  "data": "翻譯後的文字"
}

如果您正在設定自己的 DeepLX 實例，請確保它傳回此預期格式的回應。