# DeepL 翻译 API 密钥获取与使用全攻略

By [ccunsrm](https://paragraph.com/@ccunsrm) · 2025-04-01

---

随着跨语言沟通和内容本地化需求的不断提升，高效、精准的翻译工具愈发重要。DeepL 提供的翻译 API 以其卓越性能受到广泛青睐，可无缝集成到各类应用中，帮助开发者实现多语言支持的自动化。本文将详细介绍如何申请 DeepL 翻译 API 密钥，进行初步测试，并分享使用中的关键注意事项，助你快速上手。

获取 DeepL 翻译 API 密钥的步骤
---------------------

申请 DeepL 翻译 API 密钥的过程简单明了，只需几步即可完成：

*   **访问官方网站**：前往 DeepL 官网，登录或注册账号，开通 API 服务。
    
*   **选择套餐**：根据需求选择适合的 API 套餐，点击免费注册或立即订阅即可。
    
*   **进入账户管理**：开通服务后，点击右上角账户图标，进入管理界面。
    
*   **获取密钥**：在账户页面下滑，即可查看并复制你的 DeepL API 密钥。
    

完成以上步骤后，你将成功获得 API 密钥，准备进入使用阶段。

👉 [【点击获取】 DeepL PRO 高级会员独享30天（专业版）](https://bit.ly/DEepl)

测试 DeepL 翻译 API 密钥的有效性
----------------------

拿到 API 密钥后，建议先进行可用性测试，以确保其正常运行。以下是测试方法：

*   **API 端点**：付费用户使用 `api.deepl.com`，免费用户使用 `api-free.deepl.com`，请根据套餐选择正确域名。
    
*   **测试示例**：使用 `curl` 命令发送请求，例如：
    
    curl -X POST '[https://api.deepl.com/v2/translate](https://api.deepl.com/v2/translate)' -H 'Authorization: DeepL-Auth-Key 你的API密钥' -d 'text=Hello, world!' -d 'target\_lang=DE'
    
*   **输出结果**：成功请求将返回 JSON 格式的翻译结果，例如：
    
    { "translations": \[ { "detected\_source\_language": "EN", "text": "Hallo, Welt!" } \] }
    

通过测试，你可以确认密钥是否有效，并熟悉 API 的基本调用方式。

使用 DeepL 翻译 API 的关键注意事项
-----------------------

将 DeepL 翻译 API 集成到应用中时，除了获取和测试密钥，还需关注以下要点：

### 免费计划的特点

免费版 DeepL API 每月提供 50 万字符的翻译额度，适合小型项目或测试用途。

### 付费计划的优势

DeepL API Pro 提供无限制翻译，按用量计费，确保数据安全并优先处理请求，适合大规模应用。

### 免费与付费接口的区别

免费用户使用 `api-free.deepl.com`，付费用户使用 `api.deepl.com`，调用时需确保域名正确。

### 请求限制

*   总请求大小上限为 128 KiB。
    
*   免费版每月字符限额为 50 万，超出需升级套餐。
    

### 错误处理建议

*   **HTTP 429（请求过多）**：短时间内请求过多时触发，建议采用指数退避重试。
    
*   **HTTP 456（超出配额）**：免费用户超出字符限制或付费用户达到成本上限时出现，可通过升级或调整限制解决。
    
*   **HTTP 500（服务器错误）**：临时性问题，建议延迟后重试。
    

DeepL 翻译 API 使用中的常见问题解答
-----------------------

以下是申请和使用 API 密钥时常见的疑问及解答：

1.  \*\*使用 API 时需要注意什么？\*\*需关注套餐的请求限制和接口域名，确保使用正确的 `api-free.deepl.com` 或 `api.deepl.com`。
    
2.  \*\*API 密钥的使用限制有哪些？\*\*根据订阅计划，限制包括字符量和并发请求，具体可在账户页面查看。
    
3.  \*\*API 密钥过期怎么办？\*\*密钥通常不会过期，但可通过账户管理生成新密钥并更新应用。
    
4.  \*\*遇到 401 Unauthorized 错误怎么办？\*\*检查密钥是否正确输入并包含在请求头部，确保格式无误。
    

DeepL 翻译 API 的进阶应用
------------------

获得密钥后，你可以开始对接 API 接口。许多开发者已成功将 DeepL 翻译 API 应用于多语言网站、聊天工具等场景，相关案例可为你的项目提供灵感。

总结
--

本文全面介绍了获取 DeepL 翻译 API 密钥的步骤，从注册账号到选择套餐，再到测试密钥的可用性，为开发者提供了清晰的操作指南。同时，我们还探讨了使用 API 的关键因素，包括免费与付费套餐的差异、请求限制及错误处理方法。通过这些内容，你可以更高效地将 DeepL 翻译 API 集成到应用中，满足多语言需求。

---

*Originally published on [ccunsrm](https://paragraph.com/@ccunsrm/deepl-api)*