纯翻译提供商
什么是纯翻译提供商、陪读蛙支持哪些、各自需要填什么,以及什么时候该用它而不是 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 提供商。
相关页面
服务商总览 · DeepL · DeepLX · 内置服务商 · OpenAI 兼容服务商
