DeepL APIは、DeepLの翻訳エンジンを自社のシステムやスクリプトから呼び出すためのREST APIです。無料のAPI Freeは月50万文字まで使え、有料のAPI Proは文字数の上限がなく、利用量に応じて課金されます。この記事では、FreeとProの違い、認証キーの取得、curlとPythonの公式ライブラリでの翻訳、用語集APIで社名や製品名の訳を固定する方法を、そのまま動かせるコード付きの解説です。2026年1月15日に廃止された旧い認証方式のせいで、古いサンプルが403で失敗する点と、業務システムに組み込むときの判断基準も扱います。
まとめ:DeepL APIはFreeで試作しProで本番化、鍵はヘッダーで送る
試作と検証はAPI Freeで十分です。認証キーを発行し、Authorization: DeepL-Auth-Keyヘッダーを付けてPOST /v2/translateを呼べば、数分で最初の訳文が返ります。Pythonなら公式ライブラリdeeplのDeepLClientを使うと、FreeとProのエンドポイントの切り替えも再試行も自動で済みます。
本番で毎月の文字数が50万を超える、用語集を複数持ちたい、費用の上限を設定したい、のいずれかに当てはまればAPI Proに切り替えます。社名・製品名・業界用語の訳がぶれるなら、用語集(v3の多言語用語集)を最初から設計に入れてください。認証キーはブラウザ側に置かず、必ず自社のサーバーから呼び出します。逆に、訳文の文体を細かく指示したい、訳と同時に要約や分類もしたいという用途なら、DeepL APIより生成AIのAPIが向いています。
DeepL APIでできることとFree・Proの違いを上限と料金で整理
まず、DeepL APIが提供する機能と、FreeとProで何が変わるのかを押さえます。実装を始めてからプランを変えると、エンドポイントと認証キーの両方を入れ替えることになるためです。
テキスト翻訳・文書翻訳・用語集などを呼び出す主なAPIのパスと役割
DeepL APIの公式ドキュメントによると、テキスト翻訳はPOST /v2/translateで、Pro用はhttps://api.deepl.com、Free用はhttps://api-free.deepl.comがベースURLです。公式のクライアントライブラリはPython・JavaScript・PHP・.NET・Java・Rubyの6言語で提供されています。
業務システムでよく使うAPIのパスを、呼び出し方法と用途ごとに示します。
POST /v2/translate:テキストの翻訳。1リクエストのサイズは128KiBまで/v3/glossaries:用語集の作成・更新・削除GET /v2/usage:今の請求期間に使った文字数と上限の確認/v2/document:Word・PowerPoint・PDFなどのファイル翻訳GET /v3/languages:対応言語と、言語ごとに使える機能の一覧
最初に実装すべきは翻訳と使用量確認の2つです。用語集は訳語のぶれが問題になった時点で足せますが、データの持ち方に影響するので設計段階で検討しておきます。
API FreeとAPI Proの違いを月50万文字の上限とエンドポイントで比較
2026年11月時点のDeepL APIの料金ページと公式ドキュメントの記載をもとに、FreeとProの違いを並べます。
| 項目 | API Free | API Pro |
|---|---|---|
| 翻訳できる文字数 | 月50万文字まで | 上限なし(従量課金) |
| 料金 | 無料 | 月額基本料+文字数の従量 |
| エンドポイント | api-free.deepl.com | api.deepl.com |
| 認証キーの末尾 | :fx が付く | :fx なし |
| 費用の上限設定 | なし | Cost Controlで設定可 |
| 文書翻訳の1ファイル上限 | Wordで10MB・50万文字 | Wordで100MB・500万文字 |
Proの基本料と従量単価は、国・通貨・プラン構成の改定で変わります。見積もりでは料金ページの金額を、税込か税抜かも含めてその都度確認してください。Freeは上限に達するとその月の翻訳が止まるため、顧客向けの機能を載せる本番環境には使いません。
文字数の数え方と文書翻訳の最低5万文字課金で見積もりがずれる点
Usage and limitsのページによると、課金対象の文字数は原文のUnicodeコードポイント数で数えます。「A」も「あ」も「深」も1文字です。翻訳元と翻訳先が同じ言語でも課金されるため、すでに英語の文を英語に「翻訳」させるような無駄な呼び出しは、事前に言語判定で除いておきます。
見積もりがずれやすいのは文書翻訳です。.docx・.pptx・.pdfなどのファイルは、1ファイルにつき最低5万文字として課金されます。数行しかない契約書の別紙を1枚ずつ送ると、請求対象となる文字数は実際の文字数の何十倍にもなる計算です。短い文書が大量にあるなら、テキストを抜き出して/v2/translateにまとめて送るほうが安く済みます。
認証キーの取得からcurlで最初の翻訳結果を受け取るまでの作業手順
ここからは手を動かします。アカウントを作ってから最初の訳文が返るまで、コードを書かずにcurlだけで確認できます。
認証キーを発行して末尾の:fxでFree用かPro用かを見分ける手順
- DeepLのサイトでAPIのプラン(FreeまたはPro)に登録する
- アカウント画面の「APIキー」タブを開き、キーを発行してコピーする
- キーを環境変数
DEEPL_AUTH_KEYに入れ、ソースコードには書かない - キーの末尾を見て、呼び出し先のエンドポイントを決める
認証のページには、API Freeのキーは末尾に:fxが付くと書かれています。末尾が:fxならapi-free.deepl.com、付いていなければapi.deepl.comがリクエストの送信先です。取り違えると認証エラーになるので、ステージングはFree、本番はProのように環境を分ける場合は、キーとURLを同じ設定ファイルで管理しておきます。
curlでPOST /v2/translateを呼び日本語を英語に訳すリクエスト例
Free用のキーで、日本語の1文を米国英語に訳すリクエストです。翻訳APIのリファレンスどおり、textは配列で渡します。
export DEEPL_AUTH_KEY="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx:fx"
curl -X POST "https://api-free.deepl.com/v2/translate" \
--header "Authorization: DeepL-Auth-Key $DEEPL_AUTH_KEY" \
--header "Content-Type: application/json" \
--data '{
"text": ["請求書を添付しましたのでご確認ください。"],
"source_lang": "JA",
"target_lang": "EN-US",
"show_billed_characters": true
}'
成功すると、translations配列にdetected_source_languageとtext(訳文)が返ります。show_billed_charactersを付けると、その呼び出しで課金された文字数を示すbilled_charactersも返るため、見積もりを検証する際の材料になります。英語はEN-USかEN-GB、日本語を指定するときの言語コードはJAです。対応言語の一覧は対応言語のページで確かめられ、日本語は用語集・タグ処理・スタイルルールにも対応しています。
2026年1月15日以降に旧サンプルのauth_key指定が403になる理由
ネット上の古い記事には、?auth_key=...のようにクエリパラメータや、リクエストボディのauth_keyでキーを送るサンプルが残っています。DeepLは2025年11月の変更告知で、この2つの方式の廃止を発表しました。期限は当初の2025年11月1日から2026年1月15日に延期され、以降は403 Forbiddenで失敗します。
以前は動いていた社内ツールが急に403を返すようになったら、まずこの認証方式を疑ってください。直し方は、キーをAuthorization: DeepL-Auth-Keyヘッダーで送るように変えるだけです。公式ライブラリはdeepl-python 1.0.0以上、deepl-node 1.1.0以上などであればヘッダー方式に対応済みで、コードの修正はいりません。古いWordPressプラグインやノーコードツールの連携は、提供元が更新しているかを確認します。
Pythonの公式ライブラリdeeplで翻訳と使用量の確認を実装する手順
業務システムに組み込むなら、HTTPを直接組み立てるより公式ライブラリを使うほうが安全です。PyPIのdeeplパッケージは2026年11月時点で1.33系が最新で、Python 3.9以上で動きます。
pipでdeepl 1.33系を入れてDeepLClientで翻訳を返す最小コード
pip install --upgrade deepl
# translate.py
import os
import deepl
client = deepl.DeepLClient(os.environ["DEEPL_AUTH_KEY"])
texts = [
"納期は来週金曜日を予定しています。",
"見積書の有効期限は発行日から30日です。",
]
results = client.translate_text(texts, source_lang="JA", target_lang="EN-US")
for src, r in zip(texts, results):
print(src, "->", r.text)
リストを渡すと訳文もリストで返り、順番は入力と同じです。DeepLClientはキー末尾の:fxを見てFreeかProかのURLを自動で選ぶため、環境ごとにURLを書き分ける必要はありません。PyPIの説明によると、以前のTranslatorクラスは非推奨になり、次のメジャーバージョンで削除される予定です。古い記事のコードを流用する場合はDeepLClientに書き換えておきます。
get_usageで残り文字数を確かめ上限の手前で処理を止める実装
使用量APIのリファレンスによると、GET /v2/usageは今の請求期間に翻訳した文字数character_countと、上限character_limitを返します。Proで上限を設定していない場合、character_limitに返る値は1兆です。夜間バッチで大量に訳す前に、残りが足りるかを確かめます。
def can_translate(client, texts, margin=10_000):
usage = client.get_usage()
if not usage.character.valid:
return True
need = sum(len(t) for t in texts)
remain = usage.character.limit - usage.character.count
return remain - need > margin
if not can_translate(client, texts):
raise SystemExit("今月の残り文字数が足りないため翻訳を中止しました")
Pythonのlen()はコードポイント数を返すので、DeepLの課金の数え方と一致します。余裕を1万文字ほど残しておくと、同じキーを使う別の処理が途中で止まる事故を防げます。
429と5xxは再試行し456と400は止めるエラー処理の分け方
エラー処理のページは、429(リクエスト過多)と5xxは指数バックオフで再試行し、456(文字数の上限超過)と400(リクエストの誤り)は再試行しないよう案内しています。公式ライブラリは既定で最大5回まで自動で再試行し、回数はmax_retriesで変えられます。
try:
result = client.translate_text(text, target_lang="EN-US")
except deepl.QuotaExceededException:
notify_admin("DeepLの文字数上限に達しました") # 456: 再試行しても通らない
except deepl.AuthorizationException:
notify_admin("認証キーが無効です") # 403: キーまたはURLの取り違え
except deepl.DeepLException as e:
log_error(e) # 429と5xxはライブラリが再試行した後にここへ来る
456を再試行し続けると、ジョブが止まらないまま上限超過のエラーが積み上がります。上限超過を運用者に通知し、その後の対応は人が判断する運用です。REST連携全般のリトライやタイムアウトの設計は、API連携の実装方法(REST連携の5手順と認証・リトライ)で詳しく説明しています。
用語集APIで社名や製品名の訳を固定する実装と日本語での注意点
機械翻訳を業務に入れたときに最初に出る苦情は、社名や製品名、社内用語の訳が文ごとに変わることです。DeepL APIでは用語集を作り、翻訳時にそのIDを指定して訳語を固定します。
v3の多言語用語集をPythonで作成し翻訳時にglossaryを指定する例
現在の用語集はv3の多言語用語集APIで、1つの用語集に「日本語→英語」「英語→日本語」など複数の言語ペアの辞書を持てます。
from deepl import MultilingualGlossaryDictionaryEntries
entries = {
"一創": "ISSOH",
"受託開発": "custom software development",
"検収": "acceptance inspection",
}
glossary = client.create_multilingual_glossary(
"社内用語集",
[MultilingualGlossaryDictionaryEntries("JA", "EN", entries)],
)
print(glossary.glossary_id) # このIDを設定ファイルに保存する
result = client.translate_text(
"検収後に請求書を発行します。",
source_lang="JA",
target_lang="EN-US",
glossary=glossary,
)
print(result.text)
用語集を指定するときはsource_langも指定しておくと、言語の自動判定の揺れで用語集が効かない事故を避けられます。用語集の作成は毎回の翻訳では行わず、作成したIDを保存し、以降の翻訳でも同じIDを指定する運用です。用語の追加は、同じIDの辞書を置き換えるエンドポイントで行います。
用語集の上限1000件と10MiB、v2エンドポイント非推奨への備え
v3の用語集は、1アカウント1000件まで、1つの用語集は10MiBまでです。原文・訳文の各語と用語集名はそれぞれ1024バイト(UTF-8)までで、日本語は1文字3バイトなので約340文字が上限になります。翻訳時にはglossary_idsで最大5つの用語集を同時に指定できます。
旧いv2の用語集エンドポイント(/v2/glossariesなど)はリファレンス上で非推奨(DEPRECATED)と表示されています。これから作るシステムはv3で実装し、v2で作った既存の用語集はPythonライブラリの移行ガイドに沿って移す手順です。用語の原本は社内のスプレッドシートやデータベースに置き、そこからAPIで同期する形にすると、担当者がDeepLの画面を直接触らずに済みます。
業務システムへの組み込みでの認証キー管理と採用を見送る判断基準
ここまでで翻訳は動きます。ただ、問い合わせ管理や商品マスタ、多言語サイトのCMSなど既存の業務システムに組み込むときは、別の判断が必要になります。
HTMLやXMLをtag_handlingで訳しタグを壊さずに返す設定
CMSの本文や商品説明のようにHTMLを含む文を訳すときは、tag_handlingにhtmlを指定します。タグの外側だけが訳され、タグ構造は保たれます。翻訳APIのリファレンスによると、タグ処理のアルゴリズムは2025年10月にv2へ更新され、現在はこれが既定です。
訳してほしくない部分(型番やコードなど)はignore_tagsに指定したタグで囲みます。翻訳されない補足情報をcontextに渡すと訳の精度を上げられ、contextの文字は課金されません。多言語サイト全体の作り方は、多言語サイト制作の進め方(作り方3方式・費用の内訳・URL設計)にまとめています。
認証キーをブラウザ側に置かずサーバー経由で呼ぶ構成にする理由
CORSのページにあるとおり、DeepL APIはブラウザから直接送られたリクエストを受け付けません。フロントエンドのJavaScriptにキーを埋め込む構成は、動かないうえに、キーが誰にでも見える状態になります。画面からの翻訳要求は自社のAPIサーバーで受け、サーバーがDeepLを呼ぶ構成にします。
サーバーを挟むと、同じ文の訳をキャッシュして課金を抑える、利用者ごとに1日の文字数を制限する、訳文をログに残して用語集の改善に使う、といった制御も加えられます。API ProならCost Controlでサブスクリプション全体の月間上限も設定でき、上限に達するとその期間の残りは翻訳が停止する仕組みです。DeepL Proのデータセキュリティのページは、テキストをメモリ上で処理し、同意なしに保存しないと説明しています。機密文書を流す前に、契約するプランの利用規約で扱いを確認してください。
DeepL APIを採用する条件と生成AIや人手翻訳を選ぶべき場面
DeepL APIを採用するのは、訳す文の量が多く、訳の一貫性と処理速度を優先する場面です。具体的には、問い合わせメールの自動翻訳、商品マスタやマニュアルの多言語化、社内チャットの翻訳ボットなど、同じ形式の文を毎日大量に流す処理が向いています。用語集で訳語を固定でき、文字数で費用を見積もれる点が、業務システムに組み込みやすい理由です。
翻訳に加えて別の処理が必要かどうかも、採用を判断する基準です。訳と同時に要約・分類・返信文の作成までしたいなら、生成AIのAPIに任せたほうが1回の呼び出しで済みます。契約書や薬機法の表示のように誤訳が損害に直結する文書は、APIの出力を下訳にとどめ、人が必ず確認する工程を残します。1か月に数千文字しか訳さないなら、システム化せずにDeepLの画面で訳すほうが早いです。AI翻訳全体の比較と導入判断はAI翻訳とは(仕組み・精度の限界・業務導入の判断基準)、DeepL以外の選択肢はSakana TranslateとDeepLの比較を参照してください。既存の基幹システムや問い合わせ管理とDeepL APIをつなぐ開発を外部に任せたい場合は、一創のAPI開発・システム連携で、認証・用語集の同期・エラー処理を含めて設計から相談を受けています。
DeepL APIの無料枠・認証エラー・翻訳制限に関するよくある質問
DeepL APIの導入前後によく寄せられる質問に、2026年11月時点の公式ドキュメントをもとに答えます。
DeepL APIは無料でどこまで使えますか?
API Freeは月50万文字まで無料で翻訳できます。文字数は原文のUnicodeコードポイント数で数え、日本語も英語も1文字は1文字です。上限に達すると、その請求期間が終わるまで翻訳は456エラーになります。用語集や文書翻訳もFreeで試せますが、文書翻訳のファイルサイズの上限はProより小さく、Wordなら10MBまでです。
DeepL APIとDeepL Pro(翻訳アプリの有料版)は同じ契約ですか?
別の契約です。翻訳アプリやWeb画面で使うDeepL Proの個人・チーム向けプランには、APIの利用枠は含まれません。プログラムから呼び出すには、APIのプラン(API FreeかAPI Pro)に別途登録し、アカウント画面でAPI用の認証キーを発行します。料金ページでも、APIは別のタブに分かれています。
以前動いていたDeepL APIの呼び出しが403になるのはなぜですか?
多くの場合、認証キーをクエリパラメータやリクエストボディのauth_keyで送っているのが原因です。この方式は2026年1月15日に廃止され、以降は403で失敗します。キーをAuthorization: DeepL-Auth-Keyヘッダーで送るように直してください。ほかに、Free用キー(末尾:fx)をPro用のURLに送るなど、キーとエンドポイントの取り違えでも認証エラーになります。
DeepL APIで1回に送れる文字数に上限はありますか?
/v2/translateは、リクエスト全体のサイズが128KiBまでで、超えると413エラーが返ります。日本語は1文字3バイトなので、1回あたりおおむね4万文字が目安です。長い文書は段落単位に分け、textの配列に複数入れて送ります。ファイルごと訳したい場合は文書翻訳APIを使いますが、1ファイル最低5万文字分の課金になる点に注意してください。
DeepL APIの用語集は日本語に対応していますか?
日本語は用語集の対応言語です。対応言語のページで、日本語(JA)は翻訳・用語集・タグ処理・スタイルルール・翻訳メモリのいずれにも対応と表示されています。v3の多言語用語集なら、日本語→英語と英語→日本語の辞書を1つの用語集にまとめられます。1語あたりの上限は1024バイトなので、日本語では約340文字までです。
関連記事
- AI翻訳とは?仕組みと機械翻訳との違い、精度の限界・API料金・業務導入の判断基準【2026年11月】:DeepL APIを含むAI翻訳を業務に入れるかの判断
- Sakana Translateとは?使い方・文字数上限とDeepL比較【2026年11月】:DeepL以外の翻訳エンジンとの比較
- API連携の実装方法|REST連携の5手順と認証・リトライをPythonで実装【2026年11月】:外部APIを呼ぶ処理の共通設計
- ローカライズとは?翻訳・国際化との違いと対象範囲・実施可否の判断基準:翻訳APIだけでは足りない多言語対応の範囲
- 多言語AIチャットボットとは?翻訳型と多言語ナレッジ型の選び方【2026年版】:翻訳APIを組み込んだチャットボットの設計