DeepL

什么是 DeepL？

DeepL 是 DeepL 官方提供的付费翻译 API。在陪读蛙中，它与 DeepLX 是分开的：

• DeepL 使用 DeepL 官方 API，需要有效的 DeepL API Key。
• DeepLX 是非官方的类 DeepL API，支持自定义 Base URL。

如果您想使用官方 DeepL 服务，请在 API Providers 页面选择 DeepL。

陪读蛙如何配置 DeepL

陪读蛙中的 DeepL 配置非常简单：

• API Key：必填
• Base URL：不会显示，也不可配置

陪读蛙会根据您的 API Key 自动选择正确的 DeepL 端点：

• 以 :fx 结尾的密钥使用 https://api-free.deepl.com
• 其他密钥使用 https://api.deepl.com

您不需要手动区分 Free 和 Pro 端点。

在陪读蛙中设置 DeepL

1. 打开陪读蛙扩展的选项页。
2. 进入 API Providers。
3. 选择 Official DeepL API。
4. 在 API Key 字段中粘贴您的 DeepL API Key。
5. 测试一次翻译。

就这些。不需要填写 Base URL。

DeepL Free 与 Pro 密钥

陪读蛙会通过 API Key 的格式决定要请求哪个 DeepL 端点。

DeepL Free

如果您的密钥以 :fx 结尾，陪读蛙会向以下地址发送请求：

https://api-free.deepl.com/v2/translate

DeepL Pro

如果您的密钥不以 :fx 结尾，陪读蛙会向以下地址发送请求：

https://api.deepl.com/v2/translate

语言代码处理

陪读蛙会自动对部分语言代码做适配：

• 目标语言 zh 会转换为 ZH-HANS
• 目标语言 zh-TW 会转换为 ZH-HANT
• 源语言 zh-TW 会规范化为 ZH
• 当源语言设置为 auto 时，陪读蛙会让 DeepL 自动检测

常见问题排查

“DeepL API key is not configured”

说明 API Key 为空。请先在提供商设置中填写有效的 DeepL API Key。

“DeepL translation request failed”

通常表示以下情况之一：

• API Key 无效
• API Key 类型与您的 DeepL 套餐不匹配
• DeepL 服务拒绝了该请求

Free 密钥无法使用

请确认您的 DeepL Free 密钥仍然以 :fx 结尾。陪读蛙依赖这个后缀来选择 Free API 端点。

什么时候选择 DeepL，什么时候选择 DeepLX

如果您需要以下能力，请选择 DeepL：

• 官方 DeepL API
• 自动处理 Free / Pro 端点
• 只填写 API Key 的简单配置

如果您需要以下能力，请选择 DeepLX：

• 自定义或自托管 DeepLX 提供商
• 自定义 Base URL 模式
• 在 URL 中使用 {{apiKey}} 占位符