API 快速开始

1. 注册 API 账户

访问 DeepL API 定价页面选择计划并注册。如果已有 DeepL 翻译器账户，需要注销后创建新账户。免费版端点: https://api-free.deepl.com，付费版: https://api.deepl.com。

2. HTTP 请求

POST /v2/translate HTTP/2
Host: api.deepl.com
Authorization: DeepL-Auth-Key [yourAuthKey]
Content-Type: application/json

{"text":["Hello, world!"],"target_lang":"DE"}

响应:

{"translations":[{"detected_source_language":"EN","text":"Hallo, Welt!"}]}

3. cURL

安装: 无需安装

设置 API Key:

export API_KEY={YOUR_API_KEY}

curl -X POST https://api.deepl.com/v2/translate \
  --header "Content-Type: application/json" \
  --header "Authorization: DeepL-Auth-Key $API_KEY" \
  --data '{"text": ["Hello world!"],"target_lang": "DE"}'

输出:

{"translations":[{"detected_source_language":"EN","text":"Hallo, Welt!"}]}

注意: 免费版替换为 https://api-free.deepl.com

4. Python

安装:

pip install deepl

import deepl

auth_key = "{YOUR_API_KEY}"
client = deepl.DeepLClient(auth_key)

result = client.translate_text("Hello, world!", target_lang="DE")
print(result.text)  # Hallo, Welt!

生产环境建议将 API key 存储在环境变量中。

5. JavaScript / TypeScript

安装:

npm install deepl-node

import * as deepl from 'deepl-node';

const authKey = "{YOUR_API_KEY}";
const client = new deepl.DeepLClient(authKey);

(async () => {
    const result = await client.translateText('Hello, world!', null, 'de');
    console.log(result.text); // Hallo, Welt!
})();

生产环境建议将 API key 存储在环境变量中。

6. PHP

安装:

composer require deeplcom/deepl-php

require_once 'vendor/autoload.php';
use DeepL\Client;

$authKey = "{YOUR_API_KEY}";
$client = new DeepL\DeepLClient($authKey);

$result = $client->translateText('Hello, world!', null, 'de');
echo $result->text; // Hallo, Welt!

生产环境建议将 API key 存储在环境变量中。

7. C# / .NET

安装:

dotnet add package DeepL.net

using DeepL;

var authKey = "{YOUR_API_KEY}";
var client = new DeepLClient(authKey);

var translatedText = await client.TranslateTextAsync(
    "Hello, world!", null, LanguageCode.German);
Console.WriteLine(translatedText); // Hallo, Welt!

8. Java

GitHub: https://github.com/DeepL/deepl-java

import com.deepl.api.*;

public class Main {
    public static void main(String[] args) throws DeepLException, InterruptedException {
        String authKey = "{YOUR_API_KEY}";
        DeepLClient client = new DeepLClient(authKey);
        TextResult result = client.translateText("Hello, world!", null, "de");
        System.out.println(result.getText()); // Hallo, Welt!
    }
}

9. Ruby

安装:

gem install deepl-rb

require 'deepl'

DeepL.configure do |config|
    config.auth_key = '{YOUR_API_KEY}'
end

translation = DeepL.translate 'Hello, world!', nil, 'de'
puts translation.text  # Hallo, Welt!

10. 下一步

• 探索官方客户端库的完整功能
• 查看 API 端点参考了解所有参数
• 使用 API Playground 在线测试请求