DeepL 是我体验过的最出色的翻译工具之一。为了更高效地利用其功能,我们可以通过 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="your-token"
data=$(jq -n --arg glossary "$(cat glossary.tsv)" '{ name: "My Glossary", source_lang: "en", target_lang: "zh", entries: $glossary, entries_format: "tsv" }')
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 都提供了灵活的工具,让翻译更加精准和便捷。