DeepL 翻译 API 调用方式是什么

Deepl翻译 DeepL文章 2025-10-24 6

本文目录导读：

DeepL 翻译 API 调用方式是什么-第1张图片-

DeepL翻译API调用方式详解：从入门到实战
DeepL翻译API概述
API调用前准备工作
核心调用方式与参数详解
实战代码示例
常见问题与解决方案
API使用最佳实践
总结与资源推荐

DeepL翻译API调用方式详解：从入门到实战

目录导读

DeepL翻译API概述
API调用前准备工作
核心调用方式与参数详解
实战代码示例（Python与PHP）
常见问题与解决方案
API使用最佳实践
总结与资源推荐

DeepL翻译API概述

DeepL作为机器翻译领域的领先者,其API服务凭借高准确度和多语言支持（支持31种语言互译，含中文）成为开发者首选，与谷歌翻译API相比，DeepL在欧盟语言（如德语、法语）和专业文献翻译中表现更优，API基于REST架构，返回标准JSON格式数据，适合集成到网站、应用或自动化流程中。

API调用前准备工作

a. 获取API密钥

注册DeepL开发者账户（免费版每月50万字符额度）
进入控制台生成认证密钥（Authentication Key）

b. 选择服务方案

免费版：支持基础文本翻译，速率限制50万字符/月
Pro版：无字符限制，支持术语库与文档翻译
企业版：包含私有化部署与SLA保障

c. 环境配置

确保网络支持HTTPS请求（API端点为https://api-free.deepl.com/v2/translate）
安装对应语言HTTP请求库（如Python的requests）

核心调用方式与参数详解

HTTP请求方法：POST（推荐）或GET
必需参数：

auth_key：API密钥
text：待翻译文本（最多50个请求/秒，单次请求5000字符以内）
target_lang：目标语言代码（如ZH为简体中文，EN-US为美式英语）

可选参数：

source_lang：指定源语言（如未指定则自动检测）
split_sentences：控制句子分割（默认1，长句自动分段）
preserve_formatting：保留原格式（如HTML标签）
formality：调整正式程度（more/less，仅部分语言支持）

实战代码示例

Python调用示例

import requests
def deepl_translate(text, target_lang="ZH"):
    url = "https://api-free.deepl.com/v2/translate"
    params = {
        "auth_key": "YOUR_AUTH_KEY",
        "text": text,
        "target_lang": target_lang,
        "source_lang": "EN"  # 可选参数
    }
    response = requests.post(url, data=params)
    if response.status_code == 200:
        return response.json()["translations"][0]["text"]
    else:
        return f"错误代码: {response.status_code}"
# 调用示例
result = deepl_translate("Hello, world!")
print(result)  # 输出："你好，世界！"

PHP调用示例

<?php
function deeplTranslate($text, $targetLang = 'ZH') {
    $apiKey = 'YOUR_AUTH_KEY';
    $url = 'https://api-free.deepl.com/v2/translate';
    $data = array(
        'auth_key' => $apiKey,
        'text' => $text,
        'target_lang' => $targetLang
    );
    $options = array(
        'http' => array(
            'header'  => "Content-type: application/x-www-form-urlencoded\r\n",
            'method'  => 'POST',
            'content' => http_build_query($data)
        )
    );
    $context = stream_context_create($options);
    $result = file_get_contents($url, false, $context);
    if ($result !== FALSE) {
        $decoded = json_decode($result, true);
        return $decoded['translations'][0]['text'];
    }
    return "请求失败";
}
// 调用示例
echo deeplTranslate("This is a sample text.");
?>