DeepLX

什麼是 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

特殊 URL 處理

標準 DeepLX URL

對於大多數 DeepLX 供應商，如果您的 baseURL 不以 /translate 結尾，陪讀蛙會自動新增：

• 輸入: https://deeplx.example.com
• 輸出: https://deeplx.example.com/translate

附 API 令牌：

• 輸入: https://deeplx.example.com + 令牌 abc123
• 輸出: https://deeplx.example.com/abc123/translate

api.deeplx.org 特殊邏輯

對於官方的 https://api.deeplx.org 端點，陪讀蛙應用特殊邏輯，將 API 令牌插入到 .org 和 /translate 之間：

• 無令牌: https://api.deeplx.org/translate
• 有令牌: https://api.deeplx.org/your-token/translate

配置範例

不需要 API 令牌

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

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

路徑中的令牌

BaseURL: https://api.deeplx.com/{{apiKey}}
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:
   • 根據您提供者的格式設定 BaseURL
   • 如果需要，請添加您的 API Key（對於不需要密鑰的提供者請留空）
   • 如果需要自訂令牌位置，請使用 {{apiKey}} 佔位符
4. 測試翻譯: 嘗試翻譯一些文字以驗證配置是否正常運作

常見的 DeepLX 供應商

免費提供者（無需 API 密鑰）

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

付費/自架提供者

• https://api.deeplx.org（需 API 金鑰）
• 您自己的自託管實例

故障排除

URL 建構問題

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

1. 檢查您的 baseURL 格式: 確保它遵循預期的模式
2. 驗證令牌位置: 確保 {{apiKey}} 在正確的位置
3. 先不用令牌測試: 嘗試使用免費提供者來隔離設定問題

常見錯誤

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

API 回應格式

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

{
  "data": "翻译后的文本"
}

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