DeepL/deepl-python

DeepL Python Library

是什么 – DeepL API 的官方 Python 客户端，一个商业语言 AI 服务，提供高质量机器翻译、文本改进（重述）和文档翻译。

主要功能

• 文本翻译 – translate_text() 接受单个字符串或列表，自动检测源语言，并返回翻译后的文本及元数据（检测到的源语言、计费字符数、使用的模型）。选项可控制句子拆分、正式程度、术语表、自定义指令、模型类型（质量优化 vs 延迟优化）、标签处理（HTML/XML）等。
• 写作/改进 API – rephrase_text() 可以在同一语言内重写或改进段落，或更改其变体（例如美式英语 vs 英式英语）。可请求学术、商务、随意、简洁等风格，或自信、外交等语气。
• 文档翻译 – translate_document() / translate_document_from_filepath() 通过上传、轮询和下载处理完整文件（DOCX、PDF 等）。也可自行调用底层的上传/状态/下载函数。
• 术语表 – 通过新的 v3 端点创建、列出、检索和删除多语言术语表（用户定义的术语映射）。术语表可直接提供或从 CSV 上传。
• 高级功能 – 翻译记忆、风格规则、自定义指令（每请求最多 10 个）、细粒度 XML 标签处理（拆分、忽略等）。

典型用法

import deepl
client = deepl.DeepLClient("YOUR_AUTH_KEY")
# 简单文本翻译
result = client.translate_text("Hello, world!", target_lang="FR")
print(result.text)   # → Bonjour, le monde !

# 以商务风格重写英文文本
improved = client.rephrase_text(
    "A rainbouw has seven colours.",
    target_lang="EN-US",
    style=deepl.WritingStyle.BUSINESS.value,
)
print(improved.text)

安装与要求

• 使用 pip install --upgrade deepl 安装（支持 Python 3.9–3.13）。
• 依赖 requests（≥ 2.32.4）。在 Ubuntu 22.04 上可能需要 python3-cachecontrol 包。

谁会使用它 – 构建翻译功能应用、本地化流水线、内容创作工具，或任何需要以编程方式调用 DeepL 翻译或文本改进功能的服务的开发者。

---

以上所有信息均直接取自仓库的 README。