获得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。如果您是APIFree用户，请记住更新您的请...

以下是使用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 限制

限制类型	最大限制
总请求大小	128 KiB（128*1024 字节）
字符数	DeepL API 免费每月 500,000 个字符

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

文件格式	DeepL API 免费	DeepL API 专业版
Word（.docx / .doc）	10MB 500,000 个字符	30MB 100万个字符
PowerPoint (.pptx)	10MB 500,000 个字符	30MB 100万个字符
Excel (.xlsx)	10MB 500,000 个字符	30MB 100万个字符
PDF (.pdf)	10MB 500,000 个字符	30MB 100万个字符
Text (.txt)	1MB 500,000 个字符	1MB 100万个字符
HTML (.html)	5MB 500,000 个字符	5MB 100万个字符
XLIFF (.xlf/.xliff)*	10MB 500,000 个字符	10MB 100万个字符
SRT (.srt)	1MB 500,000 个字符	1MB 100万个字符

请注意，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开放平台找到。

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

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

7.  总结

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