如何获取DeepL翻译API密钥(分步指南)

在跨语言沟通和内容本地化的需求日益增长的背景下，准确、高效的翻译服务变得尤为重要。Deepl 提供了领先的翻译API，可以轻松集成到各种应用程序中，帮助开发者实现自动化的多语言支持。本文将指导你如何获取 Deepl 翻译 API 密钥，并进行初步的可用性测试，同时探讨在使用过程中需要考虑的其他关键因素。

1. 获取deepl翻译API秘钥步骤

获取deepl翻译API密钥的过程相对简单，只需几个步骤即可完成：

• 访问deepl官方网站。https://www.deepl.com/zh/pro-api首先登录/注册您的DeepL 账号，注册开通DeepL API服务。

• 选择适合您的API套餐服务，点击免费注册/立即订阅，这里选择哪个套餐均可。

• 获取APIkey 开通好API服务后，点击右上角账户进入账户管理界面。

• 点击账户分页，然后下滑页面，即可获取您的DeepL API key。

2.  deepl翻译API秘钥可用性测试

在获取API密钥后，进行可用性测试是确保其正常工作的重要步骤。下面的示例使用我们的 API Pro 端点 https://api.deepl.com。如果您是 API Free 用户，请记住更新您的请求以使用 https://api-free.deepl.com。

以下是使用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"
}'

输出：

你将得到一个JSON格式的响应，其中包含了翻译结果的详细信息，如检测到的源语言和翻译后的文本内容。

示例输出：

{
  "translations": [
    {
      "detected_source_language": "EN",
      "text": "Hallo, Welt!"
    }
  ]
}

3. 使用deepl翻译API搭建应用的其他关键考虑因素

在使用deepl翻译API搭建应用时，除了获取和测试API密钥外，还需考虑以下因素：

免费计划

使用DeepL API Free计划， 你可以每月免费翻译多达500000个字符。

付费计划

DeepL API Pro计划提供无限量翻译，并按用量计费，保证最大程度数据安全，且优先执行翻译请求。

免费与付费接口差异

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

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

请求限制：

API 限制

每种文档格式的最大上传限制

请注意，DeepL 仅支持 2.1 版本的 .xliff 文件。

错误处理：

HTTP 429：请求过多。这是您在短时间内发送大量 API 请求时可能会收到的错误。您的应用程序应配置为在延迟一段时间后重新发送请求。具体来说，我们建议使用指数退避来实施重试。这是在所有 DeepL 支持的官方客户端库中实现的。

HTTP 456：超出配额如果您是免费 API 用户，当达到每月 500,000 个字符的订阅限制时，您将收到此错误。如果您需要更多字符量，可以考虑升级订阅。如果您是 Pro API 用户，当达到成本控制限制时，您会收到此错误，如果需要继续翻译，您可以增加或删除成本控制限制。

HTTP 500：内部服务器错误。如果 DeepL 服务中出现临时错误，您将收到此错误。您的应用程序应配置为在延迟一段时间后重新发送请求。具体来说，我们建议使用指数退避来实施重试。这是在所有 DeepL 支持的官方客户端库中实现的。

4. deepl翻译API密钥申请和使用中的常见问题

在申请和使用deepl翻译API密钥过程中，你可能会遇到以下常见问题：

1. 如使用 DeepL API 时需要注意哪些关键因素

使用 DeepL API 时，需关注不同套餐的请求限制与域名。免费用户每月可翻译 500,000 个字符，付费用户则无量限制。确保使用正确的接口域名免费用户为 https://api-free.deepl.com，付费用户为 https://api.deepl.com。

2. API密钥使用限制是什么？

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

3. API密钥过期怎么办？

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

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

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

5. deepl翻译API进阶指引

在获得deepl翻译API密钥之后，即可开启API接口对接，本文整理了多篇开发者使用deepl翻译API的案例，帮助读者更有效地使用deepl翻译API：

1. 翻译文本
2. 翻译文件

6.  常见问题

问题1：如何找到deepl翻译API

幂简集成是国内领先的API集成管理平台，专注于为开发者提供全面、高效、易用的API集成解决方案。幂简API平台可以通过以下两种方式找到所需API：通过关键词搜索API(例如，输入’deepl翻译API‘这类品类词，更容易找到结果)、或者从API hub分类页进入寻找。

问题2：deepl翻译API的替代品有哪些？

市场上存在免费、付费两种替代者

例如

文本翻译API接口介绍及对接-有道 -超全API平台-幂简集成

多语言文本翻译API接口介绍及对接-APILayer -超全API平台-幂简集成

MotaWord 翻译API接口介绍及对接 -超全API平台-幂简集成

发现API-API Hub – 幂简集成

更多竞品可以在API开放平台找到。

问题3：deepl这个密钥还适用于哪些api？

翻译文本api接口、翻译文件api接口、检索语言api接口、检索使用情况和配额api接口

7.  总结

本文提供了获取 DeepL 翻译 API 密钥的详细步骤，从访问官网到注册账户，再到选择服务套餐并获取密钥，为开发者提供了实用的操作指南。通过使用密钥进行可用性测试，确保API正常工作。同时，文章还探讨了在集成 DeepL 翻译 API 时需要注意的关键因素，如免费与付费套餐的域名区别、API的请求限制和错误处理等。帮助开发者更有效地集成到应用中。