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からアップロードできる。
• 高度な機能 – 翻訳メモリ、スタイルルール、カスタム指示（1リクエストあたり最大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 から直接引用されています。