# DeepL API 常见错误信息解析

By [axcspnfmva](https://paragraph.com/@axcspnfmva) · 2025-04-01

---

**注意：** 想深入了解更多详情，可查阅 [DeepL API 技术文档](https://bit.ly/DEepl)。请注意，该文档仅提供英文版本。

常见错误代码及解决方法
-----------

### **错误 400：请求参数异常**

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

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

### **错误 403：认证失败**

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

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

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

### **错误 404：资源未找到**

_无法找到请求的资源_

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

👉 [【点击获取】 Deepl PRO 高级会员独享30天（专业版）](https://bit.ly/DEepl)

### **错误 413：请求超限**

_请求大小超出限制_

当请求内容超过支持的大小限制时，会触发此错误。有关具体限制详情，可参考 [API 技术文档](https://bit.ly/DEepl)，特别是文档翻译的相关说明。

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

### **错误 414：URI 过长**

_请求的 URI 长度超出限制_

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

### **错误 429：请求过于频繁**

_请求过多，请稍候重试_

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

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

### **错误 456：超出字符配额**

_已达到字符数限制_

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

### **错误 5xx：服务器问题**

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

---

*Originally published on [axcspnfmva](https://paragraph.com/@axcspnfmva/deepl-api)*