DeepL 是目前许多用户心目中最优秀的翻译工具之一。如果你希望更高效、自动化地利用这个强大的翻译工具,可以通过它提供的 API 接口实现更高级的功能。本文将详细解释如何使用 DeepL API,并提供示例代码帮助你快速上手。
在 DeepL 的订阅选项中,你可以选择启用 API 功能。不过需要特别注意,DeepL 的账户设置有一个独特的规则:如果你已经开通了 DeepL Pro,那么将无法使用 DeepL API,反之亦然。 因此,在开通订阅时务必要明确自己的需求,确保选择适合自己的功能。
启用 API 服务后,你将获得一个用于认证的 API token。
👉 【点击获取】 Deepl PRO 高级会员独享30天(专业版)
为了提高翻译的准确性,建议使用词汇表(glossary)功能,这可以帮助 API 更好地理解专业术语或定制化的翻译需求。以下是具体操作步骤:
以下示例展示了如何在 DeepL API 中创建一个包含自定义条目的词汇表:
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"
你也可以将词汇表保存为文件,通过以下方式上传:
bash
GLOSSARY=$(<glossary.tsv)
要查看系统中全部已创建的词汇表,可运行以下命令:
bash
curl -X GET "https://api.deepl.com/v2/glossaries"
--header "Authorization: DeepL-Auth-Key $TOKEN"
如果需要查看某个词汇表中的具体条目,可以运行以下命令:
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
当某个词汇表不再需要使用时,可以按以下步骤删除它:
bash
curl -X DELETE "https://api.deepl.com/v2/glossaries/{glossary_id}"
--header "Authorization: DeepL-Auth-Key $TOKEN"
词汇表功能仅支持指定的语言对。以下命令可帮助你获取当前支持的语言对列表:
bash
curl -X GET "https://api.deepl.com/v2/glossary-language-pairs"
--header "Authorization: DeepL-Auth-Key $TOKEN" | jq
目前,DeepL API 的词汇表仅支持两种格式:TSV 和 CSV。不过需要注意,CSV 格式只能上传,不支持下载。
通过以上方法,你可以更高效地利用 DeepL API,进一步提升翻译的定制化水平和准确性。开始使用 DeepL API,实现高级自动化翻译功能,解锁无限可能!