DeepL API 使用指南

DeepL 是我体验过的最出色的翻译工具之一。为了更高效地利用其功能,我们可以通过 DeepL API 实现自动化翻译和定制化需求。本文将详细介绍如何开通和使用 DeepL API,并结合词汇表优化翻译效果。

开通 DeepL API 的步骤

要在 DeepL 中使用 API,首先需要在订阅选项中启用 API 功能。需要注意的是,DeepL 的订阅设置有一个特别之处:开通 DeepL Pro 后无法使用 DeepL API,反之亦然。因此,在订阅时务必确认选择的是 DeepL API 服务。开通后,你将获得一个唯一的 API token,用于后续操作。

有一些第三方服务(如 DeepLX)提供免费的 DeepL API 访问,但响应速度通常比官方 API 稍慢。

结合词汇表提升翻译质量

通过创建和使用词汇表(glossary),你可以为特定术语指定翻译结果,从而提升翻译的准确性和一致性。下面是创建词汇表的步骤:

创建词汇表

以下是一个使用 API Pro Endpoint 的示例代码(Free API 用户需将地址替换为 https://api-free.deepl.com):

bash

设置 token

TOKEN="your-token"

构建词汇表数据

data=$(jq -n --arg glossary "$(cat glossary.tsv)" '{ name: "My Glossary", source_lang: "en", target_lang: "zh", entries: $glossary, entries_format: "tsv" }')

调用 API 创建词汇表

curl -X POST "https://api.deepl.com/v2/glossaries" --header "Authorization: DeepL-Auth-Key $TOKEN" --header "Content-Type: application/json" --data "$data"

你也可以将词汇表内容写入文件(如 glossary.tsv),然后通过命令 GLOSSARY=$(<glossary.tsv) 将其加载到环境变量中,再上传至 DeepL。

👉 【点击获取】Deepl PRO 高级会员独享30天(专业版)

查看和管理词汇表

获取所有词汇表

使用以下命令查看已创建的词汇表列表:

bash curl -X GET "https://api.deepl.com/v2/glossaries" --header "Authorization: DeepL-Auth-Key $TOKEN"

查看词汇表条目

要查看某个词汇表的具体内容,需指定其 ID:

bash curl -X GET "https://api.deepl.com/v2/glossaries/96ebcd10-ac05-4e43-a529-8e4bdc0d8dd2/entries" --header "Authorization: DeepL-Auth-Key $TOKEN" --header "Accept: text/tab-separated-values" -o glossary.tsv

删除词汇表

如果需要删除某个词汇表,可以使用以下命令(将 {glossary_id} 替换为实际 ID):

bash curl -X DELETE "https://api.deepl.com/v2/glossaries/{glossary_id}" --header "Authorization: DeepL-Auth-Key $TOKEN"

支持的语言对查询

DeepL API 提供多种语言对支持,可通过以下命令查看词汇表支持的语言组合:

bash curl -X GET "https://api.deepl.com/v2/glossary-language-pairs" --header "Authorization: DeepL-Auth-Key $TOKEN" | jq

需要注意的是,词汇表目前支持 TSV 和 CSV 格式,其中 CSV 仅适用于上传,不支持下载。

总结

通过 DeepL API,你可以轻松实现高效的翻译任务。结合词汇表功能,不仅能提升翻译质量,还能满足特定领域的专业需求。无论是创建、管理词汇表,还是查询支持的语言对,DeepL API 都提供了灵活的工具,让翻译更加精准和便捷。