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

陪读蛙
陪读蛙是一个开源的浏览器插件:网页和 YouTube、X 视频双语对照翻译,生词和句子一键存成闪卡复习。先装好插件,再按下面的步骤设置。
什么是 DeepLX?
DeepLX 是一个免费的非官方 API,通过逆向工程提供类似 DeepL 的翻译质量。它为需要高质量翻译服务但不想付费的开发者提供了官方 DeepL API 的替代方案。
灵活的 BaseURL 配置
陪读蛙支持灵活的 DeepLX baseURL 配置,以适配不同的 DeepLX 提供商。您可以自定义 baseURL 以匹配您提供商的特定端点格式。
令牌占位符支持
您可以在 baseURL 中使用 {{apiKey}} 占位符,将您的 API 令牌插入到任何位置。当不同的 DeepLX 提供商需要在不同的 URL 格式中使用令牌时,这非常有用。
示例:
- 路径中的令牌:
https://api.deeplx.com/{{apiKey}}/translate - 作为查询参数的令牌:
https://api.deeplx.com/v1/translate?token={{apiKey}} - 子域名中的令牌:
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
- 打开扩展选项: 点击陪读蛙扩展图标并进入选项页面
- 导航到 API 提供商: 进入 API 提供商部分
- 配置 DeepLX:
- 把 Base URL 设为提供商的完整接口地址,包含
/translate - 如果提供商需要令牌,在 Base URL 中令牌应在的位置写上
{{apiKey}},并把令牌填到 API Key - 不需要密钥的提供商,API Key 留空即可
- 把 Base URL 设为提供商的完整接口地址,包含
- 测试翻译: 尝试翻译一些文本以验证配置是否正常工作
常见的 DeepLX 提供商
免费提供商(无需 API 密钥)
https://deeplx.vercel.app/translatehttps://deeplx.herokuapp.com/translate
付费/自托管提供商
https://api.deeplx.org/{{apiKey}}/translate(需要 API 密钥,这是默认值)- 您自己的自托管实例
故障排除
URL 构造问题
如果您在 URL 构造方面遇到问题:
- 确认 Base URL 是完整的接口地址: 陪读蛙不会自动补上
/translate,Base URL 里必须包含它 - 验证令牌位置: 确保
{{apiKey}}在正确的位置 - 先不用令牌测试: 尝试使用免费提供商来隔离配置问题
常见错误
- "使用
{{apiKey}}占位符时需要 API 密钥": 您在 baseURL 中指定了{{apiKey}}但没有提供 API 密钥 - "DeepLX 翻译请求失败": 检查您的 baseURL 和 API 密钥是否正确
- 网络错误: 验证 DeepLX 提供商是否可访问且在线
API 响应格式
DeepLX 提供商应该返回以下格式的 JSON 响应:
{
"data": "翻译后的文本"
}如果您正在设置自己的 DeepLX 实例,请确保它返回这种预期格式的响应。