如何获取DeepL API密钥及集成指南

在全球化的背景下，跨语言沟通变得日益重要。DeepL提供的API以其精准的翻译质量而闻名，成为开发者实现多语言支持的首选工具之一。本文将详细介绍如何获取DeepL API密钥，并探讨在集成过程中需要考虑的关键因素，帮助开发者高效地将DeepL API集成到自己的应用中。

获取DeepL API密钥步骤

获取DeepL API密钥的过程分为几个简单步骤：

访问DeepL官方网站

首先，您需要访问DeepL官方网站并注册或登录您的DeepL账号。

选择API套餐服务

在注册开通DeepL API服务后，选择适合您的API套餐服务，并点击免费注册/立即订阅。

获取API Key

开通API服务后，点击右上角账户进入账户管理界面，并在账户分页中获取您的DeepL API key。

DeepL API密钥可用性测试

获取API密钥后，进行可用性测试是确保其正常工作的重要步骤。以下是一个使用curl进行测试的案例：

输入：

curl -X POST 'https://api.deepl.com/v2/translate' 

--header 'Authorization: DeepL-Auth-Key [yourAuthKey]' 

--header 'Content-Type: application/json' 

--data '{

  "text": [

    "Hello, world!"

  ],

  "target_lang": "DE"

}'

输出：

{

  "translations": [

    {

      "detected_source_language": "EN",

      "text": "Hallo, Welt!"

    }

  ]

}

使用DeepL API密钥搭建应用的其他关键考虑因素

免费计划与付费计划

DeepL提供API Free和Pro两种计划。API Free用户每月可免费翻译500,000个字符，而Pro计划则提供无限量翻译。

接口域名差异

每个DeepL API计划的API域名是不同的，请确保使用正确的域名。

• 免费接口域名：https://api-free.deepl.com
• 付费接口域名：https://api.deepl.com

请求限制

以下是DeepL API的一些请求限制：

• 总请求大小：128 KiB（128*1024 字节）
• 字符数：DeepL API免费每月500,000个字符

错误处理

以下是一些常见的错误处理：

• HTTP 429： 请求过多。建议使用指数退避策略重新发送请求。
• HTTP 456： 超出配额。需要升级订阅或增加成本控制限制。
• HTTP 500： 内部服务器错误。建议在延迟后重新发送请求。

FAQ

1. DeepL API密钥有哪些使用限制？

DeepL根据不同的订阅计划设定API使用限制，包括字符翻译量限制和并发请求限制。详细信息可以在DeepL账户页面或订阅计划说明中找到。

2. API密钥过期怎么办？

API密钥通常不会过期，但若需要重置密钥，可在账户页面生成新密钥，并更新到所有使用该密钥的应用中。

3. 如果API请求返回401 Unauthorized错误怎么办？

这通常是因为API密钥无效或格式不正确。请确保在请求头部正确包含密钥，并检查密钥格式。

总结

本文提供了获取DeepL翻译API密钥的详细步骤，并讨论了在集成DeepL翻译API时需要注意的关键因素，如免费与付费套餐的域名区别、API的请求限制和错误处理等，帮助开发者更有效地集成到应用中。