DeepL

# DeepL 使用指南：从入门到精通

开始使用

什么是 DeepL？ DeepL 是一款基于神经网络的 AI 翻译引擎，支持 30 多种语言，以翻译自然、准确著称。无论是个人写作、商务沟通还是开发集成，它都能提供符合语境的翻译结果。 本指南适合谁？ 适合需要高质量翻译的普通用户，以及希望将 DeepL API 集成到应用或工作流中的开发者。

安装与注册

桌面版（普通用户）

1. 访问 DeepL 官网，点击“免费下载”。
2. 下载对应操作系统版本（Windows/macOS）并安装。
3. 启动后，免费注册账号（邮箱或 Google/Apple 登录）。无需验证等待，即刻可用。

API（开发者）

1. 登录 DeepL 账户，进入 API 管理页面。
2. 选择“DeepL API Free”（免费版每月 50 万字符）或“DeepL API Pro”（付费）。
3. 创建后，页面会显示 API Key（格式如 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx:fx）。请妥善保存。

第一次调用 API / 首次使用

桌面版首次翻译

1. 打开 DeepL 应用，左上角选择源语言和目标语言（如“自动检测 → 中文”）。
2. 在输入框粘贴或输入文本，右侧实时显示翻译结果。
3. 点击“复制”或“替换原文”即可使用。

API 首次调用（代码示例）

以下是用 curl 发送翻译请求的示例：

curl -X POST 'https://api-free.deepl.com/v2/translate' \
  -H 'Authorization: DeepL-Auth-Key 你的API密钥' \
  -d 'text=Hello, world!' \
  -d 'target_lang=ZH'

解释： 向 DeepL 免费 API 端点发送 POST 请求，Authorization 头携带你的 API 密钥，text 参数为待翻译文本，target_lang=ZH 表示目标语言为中文（简体）。 预期响应：

{
  "translations": [
    {
      "detected_source_language": "EN",
      "text": "你好，世界！"
    }
  ]
}

Python 版：

import requests

url = "https://api-free.deepl.com/v2/translate"
headers = {
    "Authorization": "DeepL-Auth-Key 你的API密钥",
    "Content-Type": "application/x-www-form-urlencoded"
}
data = {
    "text": "Hello, world!",
    "target_lang": "ZH"
}
response = requests.post(url, headers=headers, data=data)
print(response.json())

常见使用场景

场景1：翻译整篇文档

桌面版支持拖拽上传 Word、PDF、PPT 等文件，自动保持原格式翻译。API 可使用 /document 端点上传文档。

场景2：浏览器插件即时翻译

安装 DeepL 浏览器扩展（Chrome/Edge），选中网页文本即可弹出翻译，无需离开页面。

场景3：应用内集成翻译

例如，在 Slack 机器人中集成 DeepL API，自动翻译收到的外语消息。使用 glossary 功能可自定义行业术语，确保专业翻译。

技巧与最佳实践

免费版限制与优化

• 免费 API 每月 50 万字符，约 5000 次短句翻译。建议缓存常用翻译结果，避免重复请求。
• 桌面版免费 每日有 1,500,000 字符限制，但无 API 调用次数限制。
• 避免翻译超长文本（超过 50000 字符），可分批发送。

常见陷阱

• 忘记在 API 请求中设置 Content-Type: application/x-www-form-urlencoded（使用 curl 时默认，但 Python 需手动指定）。
• 目标语言代码必须大写（如 ZH 而非 zh）。
• 使用 source_lang 参数可提高准确性，但非必需。

性能优化

• 开启 API 的 split_sentences 参数（默认启用），可提高长句翻译质量。
• 使用 formality 参数（仅限部分语言）控制正式/非正式语气。
• 合并多个短文本为一次请求，通过 text 参数多次出现（如 &text=hi&text=hello），减少 HTTP 开销。

掌握这些技巧，你就能充分发挥 DeepL 的翻译能力，大幅提升工作效率。