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。