DeepL API免费申请后如何查看剩余字符额度？

Question

DeepL API免费版申请后，如何查询剩余字符额度？使用DeepL翻译API时，免费配额用完后会怎样处理？如何避免超出限制？

Answer 1

1. DeepL API免费版申请后，如何查询剩余字符额度？

在使用DeepL API免费版时，了解剩余字符额度是管理配额的重要步骤。以下是查询剩余字符额度的常见方法：

1. 登录到DeepL开发者账户页面。
2. 导航至“API Usage”或类似的监控界面。
3. 查看当前周期内已使用的字符数以及剩余字符数。

此外，DeepL API还支持通过HTTP请求查询配额信息。例如，可以发送以下GET请求：

GET https://api.deepl.com/v2/usage?auth_key=YOUR_API_KEY

返回的数据将包含已用字符数和总配额等关键信息。

2. 使用DeepL翻译API时，免费配额用完后会怎样处理？

当免费配额耗尽时，DeepL API的行为如下：

• API将拒绝超出配额的请求，并返回HTTP状态码456（Quota Exceeded）。
• 错误响应中通常包含详细信息，帮助开发者理解问题所在。
• 用户需要等待新的计费周期开始，或者升级到付费计划以获得更多字符额度。

为了更好地应对这种情况，建议开发人员在代码中捕获并处理456错误。例如：

try:
    response = requests.post("https://api.deepl.com/v2/translate", data=payload, headers=headers)
    response.raise_for_status()
except requests.exceptions.HTTPError as e:
    if response.status_code == 456:
        print("配额已用完，请检查您的API使用情况。")
    else:
        raise
    

3. 如何避免超出限制？

为了避免超出DeepL API的免费配额限制，可以从以下几个方面入手：

策略	描述
优化输入内容	减少不必要的文本长度，仅翻译核心内容。
批量处理任务	合并多个小任务为一个较大的请求，降低调用次数。
定期监控使用量	通过API或控制台定期检查字符使用情况，提前预警。

此外，可以通过流程图设计一个自动化配额管理方案：

graph TD;
    A[开始] --> B{检查配额};
    B --"配额充足"--> C[执行翻译];
    B --"配额不足"--> D[暂停或通知管理员];
    C --> E[完成];
    D --> F[等待新周期或升级计划];