DeepL API 常见错误信息解析

注意: 想深入了解更多详情,可查阅 DeepL API 技术文档。请注意,该文档仅提供英文版本。

常见错误代码及解决方法

错误 400:请求参数异常

糟糕的请求,请检查错误信息及参数设置

当请求中缺少必要参数、参数拼写错误、数值不符合要求或使用了不支持的参数时,会触发此错误。建议仔细核对请求参数,确保其完整性和准确性。

错误 403:认证失败

授权失败,请提供有效的认证密钥

如果请求中的 API 密钥缺失或无效,就会出现此错误。为确保密钥有效,请确认您的订阅状态为激活。您可以在 DeepL 账户的 API 密钥管理页面查看密钥详情及订阅状态。

若需使用 DeepL API 功能,需订阅相应的 API 计划。选择适合您需求的订阅方案,确保认证密钥正常工作。

错误 404:资源未找到

无法找到请求的资源

此错误通常由 URL 路径错误引起。建议仔细检查请求的 URL,确保其准确无误。

👉 【点击获取】 Deepl PRO 高级会员独享30天(专业版)

错误 413:请求超限

请求大小超出限制

当请求内容超过支持的大小限制时,会触发此错误。有关具体限制详情,可参考 API 技术文档,特别是文档翻译的相关说明。

对于大型文本翻译,建议将其拆分为多个小请求,例如按段落分割,以避免超限问题。

错误 414:URI 过长

请求的 URI 长度超出限制

URL 过长会导致此错误,通常与网络服务器的长度限制有关。解决方法是将 GET 请求改为 POST 请求,从而绕过长度限制。

错误 429:请求过于频繁

请求过多,请稍候重试

遇到此提示时,建议暂停一段时间后再重试。若问题仍未解决,可逐步延长等待时间(例如翻倍),直至请求成功。成功后,可逐渐缩短等待间隔。

减少单次请求的文本量也有助于降低此错误的发生概率。

错误 456:超出字符配额

已达到字符数限制

当翻译字符数超过配额时,会出现此错误。建议前往 DeepL 账户的费用控制设置页面,检查并根据需要调整字符限制。

错误 5xx:服务器问题

此类错误通常表示服务器端出现临时故障。建议稍后重试,或联系 DeepL 支持团队获取帮助。