请注意:欲了解更多信息,请参考 DeepL API 技术文件。API 技术文件只有英文版。
错误代码示例
错误 400
糟糕的请求请检查错误信息以及你的参数
当请求的某必要参数缺失,或者指定的某参数不被支持,拼写错误,或者数值错误,该错误就会产生。
错误 403
授权失败。请提供一个有效的认证密钥参数
当请求中的 API 密钥丢失或不正确时,就会发生此错误。
要使 API 密钥有效,您的订阅必须处于激活状态。您可以在DeepL 账户的API 密钥下查看您的API 密钥和订阅状态。
同时也请检查你是否订阅了正确的订阅计划以满足你的使用需求。要访问 DeepL 的 API,您需要订阅DeepL API 计划。DeepL Pro Advanced 和 DeepL Pro Ultimate 订阅计划中包含 CAT 工具的认证密钥。
错误 404
无法找到请求的资源
该错误发生在 URL 错误的时候。请检查 URL 的路径。
错误 413
请求大小超出限制
当请求大小达到支持的限制时会出现此错误。
请查阅 API 技术文件,了解有关大小限制的详细信息,特别是针对文档翻译。
如果你想在一个翻译请求中翻译一个大型文本,你可以考虑把它分成多个请求,例如,按段落分割。
错误 414
请求的 URI 太长
如果 API 的 URL 过长,就会产生该错误,这是由于网络服务器的长度限制导致的。你可以通过使用 POST 请求代替 GET 请求来避免该错误。
错误 429
请求太多。请稍候片刻并重新发送请求
当你收到该提示时,请等待一段时间,然后再试。如果你再次遇到同样的错误,请在重试前等待更长的时间(例如,两倍的等待时间)。重复该过程,直到请求成功。然后你可以再次逐渐缩短等待时间。
在单个请求中发送较少的文本可能会减少发生该类型错误的可能性。
错误 456
超出配额。已达到字符数限制
当你达到你的字符限制时,该错误就会产生。请检查DeepL 账户中的费用控制设置,必要时提高限制。
错误 5**
内部错误
任何以 5 开头的错误类型都是内部错误。如果你遇到 503 错误,请等待片刻,稍后再试。如果你遇到其他错误提示,请联系 DeepL 客服。