DeepL翻译API使用指南，从入门到精通

DeepL文章 DeepL文章 2025-12-14 5

目录导读

DeepL API简介与优势
注册与获取API密钥
API基础调用方法
高级功能与参数详解
常见问题解答
最佳实践与SEO优化建议

DeepL API简介与优势

DeepL作为目前公认准确度最高的机器翻译服务之一,其API接口为开发者和企业提供了强大的多语言翻译能力，与公开的网页版翻译不同，DeepL API允许用户以编程方式集成高质量的翻译功能到自己的应用程序、网站或工作流程中。

DeepL翻译API使用指南，从入门到精通-第1张图片-Deepl翻译 - Deepl翻译下载【官方网站】

DeepL API的主要优势包括：

翻译质量卓越：采用先进的神经网络技术，尤其在欧洲语言间的翻译表现突出
支持多种格式：不仅支持纯文本，还能处理HTML、XML等结构化文档
高度可定制：提供形式化、非正式化等语气选项，适应不同场景需求
良好的扩展性：按使用量计费，适合从小型项目到企业级应用的各种规模

注册与获取API密钥

注册DeepL账户

访问DeepL官网（deepl.com）
点击"API"或"开发者"选项
选择适合的计划（免费版每月可翻译50万字符）
完成注册和验证流程

获取API密钥

注册成功后,在控制面板的"账户"部分可以找到您的认证密钥（Authentication Key），这个密钥是调用API的唯一凭证，需要妥善保管。

重要提示：免费版和付费版的API端点不同：

免费版：https://api-free.deepl.com/v2/translate
付费版：https://api.deepl.com/v2/translate

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'

Python示例代码

import requests
def deepl_translate(text, target_lang='ZH', auth_key='您的API密钥'):
    url = "https://api-free.deepl.com/v2/translate"
    headers = {
        "Authorization": f"DeepL-Auth-Key {auth_key}",
        "Content-Type": "application/x-www-form-urlencoded"
    }
    data = {
        "text": text,
        "target_lang": target_lang
    }
    response = requests.post(url, headers=headers, data=data)
    return response.json()
# 使用示例
result = deepl_translate("How to use DeepL API", "ZH")
print(result['translations'][0]['text'])

JavaScript/Node.js示例

const axios = require('axios');
async function translateText(text, targetLang = 'ZH') {
    const response = await axios.post(
        'https://api-free.deepl.com/v2/translate',
        new URLSearchParams({
            text: text,
            target_lang: targetLang
        }),
        {
            headers: {
                'Authorization': 'DeepL-Auth-Key [您的API密钥]',
                'Content-Type': 'application/x-www-form-urlencoded'
            }
        }
    );
    return response.data;
}

高级功能与参数详解

源语言自动检测

DeepL API可以自动检测输入文本的语言：

data = {
    "text": "This text will be auto-detected",
    "target_lang": "ZH"
    # 不指定source_lang参数即可启用自动检测
}

多文本批量翻译

data = {
    "text": ["First text", "Second text", "Third text"],
    "target_lang": "ZH"
}

形式化控制

通过formality参数控制翻译语气：

more：更正式（适用于商务文件）
less：更随意（适用于社交媒体）
default：自动选择

data = {
    "text": "How are you?",
    "target_lang": "DE",
    "formality": "more"  # 德语正式表达
}

术语表功能

DeepL Pro用户可以使用术语表确保特定词汇的一致性翻译：

data = {
    "text": "The CEO will attend the meeting.",
    "target_lang": "FR",
    "glossary_id": "您的术语表ID"
}

标签处理

翻译HTML/XML内容时，保留标签结构：

data = {
    "text": '<p>This is <strong>important</strong> text.</p>',
    "target_lang": "ES",
    "tag_handling": "html"
}

常见问题解答

Q1: DeepL API免费版有哪些限制？

A: 免费版每月提供50万字符的翻译额度，支持所有语言对，但无法使用术语表等高级功能，且API调用频率有限制。

Q2: 如何选择合适的语言代码？

A: DeepL使用ISO 639-1标准语言代码，如：

中文：ZH
英语：EN
日语：JA
德语：DE
法语：FR
西班牙语：ES

Q3: API调用失败常见原因有哪些？

A: 常见原因包括：API密钥错误、超过使用限额、网络连接问题、不支持的语言对、参数格式错误等。

Q4: 如何估算API使用成本？

A: DeepL按字符数计费，每百万字符约20-25欧元（具体价格因计划而异），建议先使用免费版测试，再根据实际需求升级。

Q5: DeepL API支持哪些文件格式？

A: 除了纯文本，还支持.docx、.pptx、.pdf、.txt等文档格式的直接翻译（需使用文档翻译端点）。

最佳实践与SEO优化建议

性能优化

批量处理：将多个文本合并为一次API调用，减少网络开销
缓存机制：对重复内容实施缓存，避免重复翻译
异步处理：对于大量翻译任务，使用异步调用避免阻塞

错误处理

try:
    response = requests.post(url, headers=headers, data=data, timeout=10)
    response.raise_for_status()
    result = response.json()
except requests.exceptions.Timeout:
    # 处理超时
    pass
except requests.exceptions.RequestException as e:
    # 处理其他请求错误
    pass