常见问题#

通用排查：按 F12 打开浏览器开发者工具，切换到“网络”（Network）查看请求的 Response 详情，绝大多数报错都能在此定位。

为什么翻译结果为空、仅显示原文，或显示为 null？#

出现这种情况，可能由以下原因导致：

1. 配置问题

• API 密钥（API Key）填写错误或未生效；
• 翻译接口参数设置不正确。

2. 额度与速率问题

• 账户可用额度（Credits / Token）已用尽；
• 翻译速率过高，或接口暂时不稳定。

3. 缓存问题

• 翻译缓存中错误地保存了原文，导致重复请求时直接返回原文。

4. 网络与访问限制

• 所选 AI 接口（如 OpenAI、Gemini、Claude 等）不支持中国大陆 IP 访问；
• 当前网络或代理配置异常，导致请求无法正常发送。

✅ 解决方案：

• 核对 API Key 及接口配置；
• 检查账户额度与调用速率；
• 禁用或清空翻译缓存后重试；
• 确认网络环境符合接口访问要求。

若仅有部分内容未能翻译成功，可再次点击 “翻译” 按钮。启用缓存后，系统会自动跳过已翻译部分，避免重复请求与重复扣费。

为什么翻译速度会比较慢？为什么免费 GTX 接口反而更快？#

这里的关键是“翻译速率”，它本质上就是“并发数（一次同时发出多少个请求）”。

• GTX 看起来更快：默认并发更高、响应体更短，所以整体更快。但它有更严格的频率/额度限制，长时间大批量容易被限流。
• AI 接口偏稳：默认并发较低，是为了减少 429（Rate limit）或“token 上下文超限”等错误，新手更不容易踩坑。

想更快：把「翻译速率」从 20 逐步加到 30/50，若出现 429 或空结果就回退一点。

小提示：

• 开启翻译缓存后，重复内容会被跳过，二次翻译会更快。
• 网络环境和所选模型也会影响速度，必要时可换模型或稍后再试。

AI 翻译质量不理想怎么办？#

建议按以下顺序排查：

• 恢复默认：在“翻译设置”中重置配置，先用一小段文本复测。
• 调整采样温度（默认 0.7）：
  • 0～0.3：技术/术语严格，追求稳定一致
  • 0.4～0.7：通用内容，均衡
  • 0.8～1.0：更具创造性（营销/意译）

注：绝大多数 70B+ 主流在线大模型本身翻译没大问题，问题多由温度设置不当导致。

为什么要用第三方接口访问 DeepL？#

因为 DeepL 的官方服务不允许直接从网页上调用，所以我们通过一个“中转通道”来帮你把请求发出去。

这个中转接口只是用来传输数据，不会收集你的任何信息，你可以放心使用。如果你对稳定性有更高要求，也可以自己搭建这个通道。

我的 API Key 会被保存吗？#

不会的！你的 API Key 和其他设置都只保存在你自己的浏览器里，我们不会上传或记录任何信息。

为什么没有启用 GTX Web 接口？#

GTX Web 对服务器压力比较大，所以默认没有开启。

如果你是在自己电脑上使用这个工具，可以手动开启。请避免在开启全局代理的网络环境下使用该接口，可能会导致翻译异常。