逐步教你如何获取 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. 常见问题

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

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

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

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

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

7. 总结

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