陪读蛙
模型提供商

DeepLX

DeepLX 是一个免费的非官方翻译 API,翻译质量接近 DeepL。这篇讲怎么在陪读蛙里接入:baseURL 的写法、API Token 放在哪里,以及不需要 Key 的接口。

陪读蛙

陪读蛙是一个开源的浏览器插件:网页和 YouTube、X 视频双语对照翻译,生词和句子一键存成闪卡复习。先装好插件,再按下面的步骤设置。

安装到 Chrome6 万多 Chrome 用户正在使用其他浏览器FirefoxEdge

什么是 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 实例,请确保它返回这种预期格式的响应。

本页目录