# DeepL API 使用指南

By [izbkdacpp](https://paragraph.com/@izbkdacpp) · 2025-04-01

---

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](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天（专业版）](https://bit.ly/DEepl)

查看和管理词汇表
--------

### 获取所有词汇表

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

bash curl -X GET "[https://api.deepl.com/v2/glossaries](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](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}](https://api.deepl.com/v2/glossaries/%7Bglossary_id%7D)" --header "Authorization: DeepL-Auth-Key $TOKEN"

支持的语言对查询
--------

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

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

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

总结
--

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

---

*Originally published on [izbkdacpp](https://paragraph.com/@izbkdacpp/deepl-api)*