DeepL APIとは何ができるのか、翻訳以外の機能も含めて整理
翻訳APIで自社システムに組み込めること
室谷代表取締役DeepL APIって名前だけ見ると翻訳専用の道具に見えるんですけど、実態はREST API群で、翻訳の外側にも手を広げてるんですよね。
テキトー教師DotAI 認定講師初めて触る人は「翻訳するためのAPI」で理解が止まりがちです。現場でよく聞くのも「要は高性能な翻訳ツールですよね」という受け止め方で、そこから先に進まないことが多いんですよ。
室谷代表取締役そこはもったいない話で。自社の社内システムやアプリに組み込む前提で作られているので、業務フローの途中に翻訳を埋め込む発想ができる。
MYUUUでも海外の提携先とのやり取りはまだ人の手が入っていて、ここは構造的にコストが残る部分なんですよね。
MYUUUでも海外の提携先とのやり取りはまだ人の手が入っていて、ここは構造的にコストが残る部分なんですよね。
テキトー教師DotAI 認定講師手作業の翻訳って、時給で換算すると地味に重いんですよ。仕組みに寄せられるかどうかで、同じ人数でも回せる量が変わってきますから。
文章改善のWrite用APIと音声系のVoice用APIの違い
テキトー教師DotAI 認定講師で、翻訳の隣にあるのが文章改善のWrite用APIと、音声系のVoice用APIなんですけど、ここが一番ごちゃっとしやすいところで。
室谷代表取締役性質がまるで違うんですよ。Writeは訳すんじゃなくて、書いた文章を整えるほう。
Voiceはリアルタイムの音声翻訳と文字起こしを扱う系統です。
Voiceはリアルタイムの音声翻訳と文字起こしを扱う系統です。
テキトー教師DotAI 認定講師翻訳は言語をまたぐ、Writeは同じ言語のまま質を上げる、Voiceは音を扱う。この切り分けで覚えると混乱しにくいです。
会議の録音を何とかしたいのか、英文を磨きたいのかで、そもそも見るべきAPIが変わるわけですね。
会議の録音を何とかしたいのか、英文を磨きたいのかで、そもそも見るべきAPIが変わるわけですね。
室谷代表取締役そうなんですよ。で、この3系統がひとつの契約でまとめて使えるのか、別扱いになるのか。
契約の前に公式のプラン表で必ず確認してほしいところで、そこは実際に金額が変わってきますから。
契約の前に公式のプラン表で必ず確認してほしいところで、そこは実際に金額が変わってきますから。
提供元と基本仕様をまず押さえる
テキトー教師DotAI 認定講師先に全体像を一枚にしておくと、こういう整理になります。
| 系統 | 何をするか |
|---|---|
| 翻訳API | テキストや文書を別の言語に訳す |
| Write用API | 文章の改善・校正 |
| Voice用API | リアルタイム音声翻訳・文字起こし |
室谷代表取締役提供元はドイツのDeepL社。形態はREST APIで、公式のクライアントライブラリはPython、JavaScript、PHP、.NET、Java、Rubyあたりまで対応していて、コミュニティ版だとDartやGo、Rustもあるという整理です。
テキトー教師DotAI 認定講師
室谷代表取締役ただ、どの系統が自分の契約に含まれるかはプラン次第なので、機能の名前だけ先に覚えて、実際の可否は公式で確認する。この順番が安全です。
今申し込めるのはDeveloperとGrowthだけ、旧FreeとProは新規購入できない
DeepL APIプランの現状
旧Free・旧Pro
- 新規購入は不可
- 既存契約者は継続可能
- ネット上の比較記事はこの前提が多い
- 旧Proは基本料金+従量課金
- 無料文字数なし・費用は青天井になり得る
現行プラン
- 新規登録はDeveloper・Growth・Enterprise
- Developerは無料
- Growthは有料
- Enterpriseは事前購入型
- Growthは固定費+従量課金
ネット上に多い「API Free」「API Pro」の説明が古い理由
室谷代表取締役DeepL APIを調べると、だいたい「無料枠は月50万文字、足りなくなったら有料プランへ」みたいな比較記事が上に出てくるんですよね。でもあれ、公式ヘルプを読むと今は新規購入できないプランの話なんですよ。
テキトー教師DotAI 認定講師そこ、最初に混乱する人が多いところで。現場でよく聞くのも「無料枠を使い切ったら有料のほうに切り替えればいいんですよね」なんですけど、その有料プランがそもそも申し込めないんです。
室谷代表取締役既存の契約者はそのまま継続できるので、書いた人も悪気なく古い前提のまま更新していないわけです。契約年数を重ねた企業ほど旧プランで動いているので、情報の非対称が生まれやすい。
テキトー教師DotAI 認定講師なるほど、記事が間違っているというより、読む側が「これはいつ時点の前提の話か」を確かめる必要があるんですね。
旧Proは基本料金+従量課金、無料文字数なしのプランだった
室谷代表取締役で、旧Proがどんな形だったかというと、月額の基本料金に文字数に応じた従量課金が乗る。無料で使える文字数は付いてこないタイプです。
使った分だけ請求が積み上がる。
使った分だけ請求が積み上がる。
テキトー教師DotAI 認定講師翻訳文字数の上限がない代わりに、費用は青天井になり得る。初めて触る人が一番びっくりするのがそこですよね。
試しに動かした分も普通に課金対象なんです。
試しに動かした分も普通に課金対象なんです。
室谷代表取締役今のGrowthも固定費+使った分という骨格は同じなんですよ。この骨格さえ頭に入っていれば、プラン名が変わっても読み替えられる。
名前を暗記するより構造で覚えたほうが強いです。
名前を暗記するより構造で覚えたほうが強いです。
テキトー教師DotAI 認定講師DeveloperとGrowthの関係を先に地図として持っておく
室谷代表取締役今の新規登録はシンプルで、無料のDeveloper、有料のGrowth、そして事前購入型のEnterpriseという並びなんですよね。個人がまず触るのはDeveloper一択です。
テキトー教師DotAI 認定講師Developerは無料クレジットが一度だけ配られるタイプで、使い切っても自動では補充されない。ここを知らずに毎月リセットされると思い込むと、ある日突然止まって焦ります。
室谷代表取締役その先にGrowthがある、という一本道で捉えるのが正しい地図です。旧Freeと旧Proの二段構えを今の絵だと思っていると、そもそも選択肢が存在しない。
テキトー教師DotAI 認定講師最初にこの地図を持っておくと、この先の話がすごく追いやすくなりますね。料金の話も、どのプランの話をしているのか迷わなくなります。
DeepL APIは無料で使える?Developerプランの上限とリセットされない点
Developerで試せるのは合計100万文字まで
室谷代表取締役まず前提を揃えておくと、今から申し込めるなかで「無料で試せる」枠はDeveloperなんですよね。合計100万文字までのクレジットが付く、という形です。
テキトー教師DotAI 認定講師たしかに。ただ最初に戸惑うのが、これを毎月もらえる無料枠だと受け取ってしまうケースなんですよ。
前の章で旧Freeの話をやったので、余計に混ざりやすいんだと思います。
前の章で旧Freeの話をやったので、余計に混ざりやすいんだと思います。
室谷代表取締役そこなんですよ。合計100万文字で、一度きり。
毎月リセットされるタイプの無料枠とは別物なんです。
毎月リセットされるタイプの無料枠とは別物なんです。
テキトー教師DotAI 認定講師現場でよく聞くのも「今月使い切っても、来月また使えるんですよね」なんですけど、そこが違うと。最初に腹落ちさせておきたいところですね。
上限に達したら自動では戻らない、次はGrowthへ
室谷代表取締役合計100万文字を使い切ると、自動ではリセットされない。Growthにアップグレードするか、そこで止まるか。
ここを決めずに走り出すと、本番の直前に詰むんですよね。
ここを決めずに走り出すと、本番の直前に詰むんですよね。
テキトー教師DotAI 認定講師現場感覚で言うと、検証中は全然気にならないんですよ。でも社内の誰かが一斉に触った瞬間に一気に減るので、そこで初めて青くなる。
室谷代表取締役MYUUU だと、検証用のキーと本番用のキーは最初から分けてます。Developer で試して、実運用に載せるなら Growth に上げる。
金額の話は次の章でやりますけど、実質の判断は「いつ上げるか」だけなんですよ。
金額の話は次の章でやりますけど、実質の判断は「いつ上げるか」だけなんですよ。
テキトー教師DotAI 認定講師なるほど、キーを分けておけば残量の減り方も見えますからね。
無料枠に含まれない機能を先に知っておく
室谷代表取締役もう一つ、Developer で何が含まれないかを先に押さえておきたいんですよ。音声のテキスト化、いわゆる Voice 用のAPIは含まれません。
一方で文章改善の Write 用API、Write Pro のほうは含まれるので、そこは混同しないほうがいい。
一方で文章改善の Write 用API、Write Pro のほうは含まれるので、そこは混同しないほうがいい。
テキトー教師DotAI 認定講師初めて触る人は「翻訳だけのプラン」だと思い込んでるんですけど、書き物の改善までカバーされてるんですね。逆に音声をやりたいなら、最初から別の話として考えるべきだと。
室谷代表取締役そうです。音声まで視野に入れてるなら、Developer で試すというより、最初から Growth 前提で予算を組む話になる。
ここを混ぜると、あとで「聞いてた話と違う」になりがちなんですよね。
ここを混ぜると、あとで「聞いてた話と違う」になりがちなんですよね。
テキトー教師DotAI 認定講師先に知っておくだけで、だいぶ静かに進められますね。
料金はいくら?Growthプランの月額と従量課金の仕組み

月払いと年払いで何が変わるのか
室谷代表取締役Growthは固定費+従量課金のプランで、年払いにすると月あたりの固定部分が¥3,025(税込)になるんですよね。ここに使った分の料金が乗ってくる構造です。
テキトー教師DotAI 認定講師月額だけ見て「安いじゃん」と判断すると危ないやつですね。
室谷代表取締役そうそう。年払いは年間12,000,000文字と音声120時間が基本に含まれていて、月払いだと1,000,000文字+音声10時間。
同じGrowthでも中に入ってる量が違うんですよ。
同じGrowthでも中に入ってる量が違うんですよ。
テキトー教師DotAI 認定講師最初に戸惑うのがまさにそこで、月払いの感覚のまま年払いの画面を開くと数字が合わない、という声を現場でよく聞きます。
基本枠を超えた分は翻訳と音声でどう課金されるか
テキトー教師DotAI 認定講師超過分の単価は、翻訳・音声テキスト化・音声対音声で全部違うんですよね。並べるとこうです。
| 項目 | 追加分の単価(税込) |
|---|---|
| 翻訳文字数 | 100万文字あたり¥2,750 |
| 音声テキスト化 | 1時間あたり¥314 |
| 音声対音声翻訳 | 1時間あたり¥627 |
室谷代表取締役文字だけ見てると音声の単価を見落とすんですよ。会議の録音を回す運用にすると、翻訳より音声側のほうが効いてくる・・・
テキトー教師DotAI 認定講師見積もりが崩れるの、だいたいそこです。文字数だけ計算して音声を足し忘れる。
従量課金の考え方そのものは、DeepSeek-V4.1-Flash-1017とは?料金・ピーク時間と実測、Search APIみたいに他社APIと並べて見ると整理しやすいです。
従量課金の考え方そのものは、DeepSeek-V4.1-Flash-1017とは?料金・ピーク時間と実測、Search APIみたいに他社APIと並べて見ると整理しやすいです。
月間の利用上限と、日本からの申し込みで見ておくべき表示
室谷代表取締役上限の話も地味に大事で。Growthは月間で5,000万文字・音声300時間まで、そこに達すると請求期間が終わるまで追加のリクエストが処理されないんですよね。
テキトー教師DotAI 認定講師止まるんですね。気づかないまま本番で止まるのが一番怖い。
室谷代表取締役だから契約時にコストコントロールを先に決めておく。MYUUUでも上限から逆算して運用を回してます。
時給で換算すると翻訳を人手で回すほうが高くつくので、上限設計さえ外さなければ費用は怖くないんですよ。
時給で換算すると翻訳を人手で回すほうが高くつくので、上限設計さえ外さなければ費用は怖くないんですよ。
テキトー教師DotAI 認定講師表示価格は日本から申し込むと円で出ますが、プラン選択画面でしか確定しないので、申し込み直前に公式で確認するのが確実です。月払いの円建て金額もそこで見てください。
無料と有料のどちらを選ぶか、個人開発と業務利用の分かれ目
無料(Developer)か有料(Growth)かの分かれ目
翻訳したい文字数の総量が100万文字に収まる見込みか?
YES / 収まる
- Developerで検証・個人開発を最後まで進められる
- 数百文字のサンプルで挙動を確認する
- 上限到達後は自動リセットされない点に注意
NO / 収まらない/人や業務が乗る
- Growthへ移行を検討
- APIキーを最大10個持ち、キー単位で月間文字数上限を設定
- サブスクリプション側にも月間料金上限を設定
- 上限到達時は請求期間終了まで追加リクエストは処理されない
- 監視を入れて静かに止まる事態に備える
検証段階・個人開発ならDeveloperで足りるケース
室谷代表取締役まず前提として、今から申し込める中で「無料で試せる側」はDeveloperなんですよね。合計100万文字までのクレジットが一度だけ付いて、そこまでは費用ゼロ。
個人で小さなツールを試す分には十分すぎる量です。ただ、上限に達しても自動ではリセットされません。
個人で小さなツールを試す分には十分すぎる量です。ただ、上限に達しても自動ではリセットされません。
テキトー教師DotAI 認定講師そこ、最初に戸惑うところなんですよ。「毎月一定量が無料で戻ってくる」という認識のまま来る人が多くて、止まった瞬間に「壊れた」と思ってしまう。
実際はプランの仕様であって、不具合ではないんですよね。
実際はプランの仕様であって、不具合ではないんですよね。
室谷代表取締役そう。検証段階の判断はシンプルで、翻訳したい文字数の総量が100万文字に収まる見込みがあるか、です。
収まるならDeveloperで最後まで行けます。料金の内訳は先ほど見た通りなので繰り返しませんが、ここだけ押さえれば個人開発はほぼ詰まない。
収まるならDeveloperで最後まで行けます。料金の内訳は先ほど見た通りなので繰り返しませんが、ここだけ押さえれば個人開発はほぼ詰まない。
テキトー教師DotAI 認定講師現場感覚で言うと、いきなり本番の業務データを流すより、まず数百文字のサンプルで挙動を見るほうが早いです。減り方が体で分かると、その後の判断がぶれません。
業務利用で見落としがちな確認点
テキトー教師DotAI 認定講師個人で試して問題なかったのに、業務に載せた瞬間に詰まる、というのが一番多いパターンです。原因はたいてい技術ではなくて、キーの持ち方と上限の管理なんですよね。
室谷代表取締役これは経営目線で言うと、コストの話というより「止まる前提で作る」という話なんです。GrowthはAPIキーを最大10個まで持てて、キー単位で月間の文字数上限を設定できます。
サブスクリプション側にも月間の料金上限が置ける。で、上限に達するとその請求期間が終わるまで追加のリクエストは処理されない。
サブスクリプション側にも月間の料金上限が置ける。で、上限に達するとその請求期間が終わるまで追加のリクエストは処理されない。
テキトー教師DotAI 認定講師静かに止まるのが怖いんですよ。エラーを吐いて盛大に落ちてくれれば気づくのに、翻訳だけ返ってこない状態が数日続く。
まず監視を入れる、が業務利用の最低ラインだと思います。
まず監視を入れる、が業務利用の最低ラインだと思います。
室谷代表取締役あとDeveloperはキーが1個しか持てないので、開発者と運用担当が同じキーを共有する形になりがちです。人の体制が乗る時点で、プランを上げるかどうかの分かれ目はそこに来る。
あとからGrowthへ上げる前提で最初から設計しておく
室谷代表取締役個人開発でも、あとから人や業務が乗る前提で作っておくと移行が楽です。まず効くのが接続先の切り替え。
無料系と有料系でホストが api-free.deepl.com と api.deepl.com に分かれるので、コードに直書きせず設定で差し替えられるようにしておく。
無料系と有料系でホストが api-free.deepl.com と api.deepl.com に分かれるので、コードに直書きせず設定で差し替えられるようにしておく。
テキトー教師DotAI 認定講師初めて触る人は、動いたときのURLをそのままコピーして埋め込みがちなんですよね。で、プランを上げた日に「なんで動かないんだ」となる。
設定ファイルに逃がしておくだけで、その作業が数分で終わります。
設定ファイルに逃がしておくだけで、その作業が数分で終わります。
室谷代表取締役キーも同じで、1個前提でハードコードすると、キーを分けたくなったときに全箇所を直すことになる。最初から環境変数なり設定なりから読む形にしておけば、Growthに上げた後のキー運用がそのまま乗ります。
テキトー教師DotAI 認定講師あとは使った文字数をログに残しておくことですね。どのくらい消費したかが手元で見えていれば、上限に近づいたタイミングで判断できます。
勘で運用するのが一番危ないので。
勘で運用するのが一番危ないので。
APIキーはどこで取る?登録からキー発行・管理までの手順
APIキー取得・管理の流れ
- 01アカウント登録DeepL公式サイトでアカウントを作成する
- 02ログイン作成したアカウントでログインする
- 03「アカウント」を開くログイン後の管理画面から「アカウント」を開く
- 04「APIキーと制限」タブを開くキーの文字列を確認・コピーできる
- 05キーを新規作成新規作成の操作を行い、キーに名前を付ける
- 06名前変更・無効化名称変更で用途を識別。不要なキーは無効化(復元不可)
アカウント登録してログインするまで
- DeepLの公式サイトでアカウントを作成する(入力項目や確認メールの流れは公式の案内に従う)
- 作成したアカウントでログインする
- ログイン後の管理画面から「アカウント」を開く
室谷代表取締役キーの話に入る前に、入口だけ揃えておきましょう。DeepLのアカウントを作って、ログインして、管理画面の「アカウント」を開く。
ここまでが全部の前提なんですよね。
ここまでが全部の前提なんですよね。
テキトー教師DotAI 認定講師たしかに。初めて触る人は、翻訳のWeb版で使っているアカウントと、APIの管理画面が同じ場所にあると気づかずに、別で登録しようとする人がけっこういます。
室谷代表取締役そこは混同しやすいところです。Web版で使っているアカウントでそのままログインして、中の「アカウント」を見にいく。
この順番だけ覚えてもらえれば十分です。
この順番だけ覚えてもらえれば十分です。
「APIキーと制限」タブでキーを確認する
テキトー教師DotAI 認定講師「アカウント」を開いたあとにどこを見るか、なんですけど。「APIキーと制限」というタブがあるので、そこを開きます。
室谷代表取締役そこでキーの文字列が見えて、コピーもできる。発行済みのキーを探し回る必要はないんですよね。
テキトー教師DotAI 認定講師最初に戸惑うのが、キーが一覧に並んでいるのを見て「これ全部使っていいのか」と迷うケースです。画面に出ているものが有効なキーなので、そのまま使えます。
室谷代表取締役あと、このタブはキーの確認だけじゃなくて、あとから上限をかける場所にもなります。最初は「キーを見るところ」でいいんですが、運用に入ると制限をかけに戻ってくることになります。
キーの新規作成・名前変更・無効化の操作
- 「APIキーと制限」タブを開く
- 新しく作るときは新規作成の操作を行い、キーに名前を付ける
- 名前を変えたいときは、対象のキーの名称を変更する
- 使わなくなったキーは無効化する(無効化したキーは復元できない)
テキトー教師DotAI 認定講師名前に手を入れられるの、地味に大事なんですよ。あとから「このキー、どこで使ってたっけ」となりがちなので、用途ごとに名前を変えておくと事故が減ります。
室谷代表取締役無効化が取り消せない、というのも先に言っておきたいところです。削除と同じ感覚で押すと戻せないので、止める判断は慎重に、と。
テキトー教師DotAI 認定講師現場でよく聞くのは、試しに作ったキーを消し忘れて、どこかで動き続けているパターンです。使っていないキーは名前で見分けられるようにしておくのが安全ですね。
室谷代表取締役同時に持てるキーの本数はプランで決まっている
| プラン | 同時に有効化できるキー数 |
|---|---|
| Developer | 1個 |
| Free(旧) | 最大2個 |
| Growth | 最大10個 |
| Pro(旧) | 最大25個 |
| Enterprise | 上限を自由に設定 |
室谷代表取締役ここ、プラン選びに効いてくるんですよ。Developerだとキーは1個だけ。
開発用と本番用を分けたい、となった時点で足りなくなります。
開発用と本番用を分けたい、となった時点で足りなくなります。
テキトー教師DotAI 認定講師翻訳の精度は同じなのに、キーを分けられないだけで詰む、というのは現場でけっこうあります。機能差より運用の都合で上位プランが必要になるケースですね。
室谷代表取締役経営目線で言うと、キーを分けられないと誰がどの用途で使ったのか追えなくて、コストの説明ができないんですよね。そこは月額以上の差になる部分です。
テキトー教師DotAI 認定講師納得です。まずは1個で始めて、分けたくなったらプランを見直す。
その順番でも遅くはないと思います。
その順番でも遅くはないと思います。
翻訳リクエストの基本形と、認証ヘッダーで送るべき理由
無料系と有料系でエンドポイントが違う
室谷代表取締役キーが手に入ったら、次は実際に投げる番です。ここで最初に引っかかるのが接続先で、無料系のプランは api-free.deepl.com、有料系は api.deepl.com と、ホスト名の段階で分かれているんですよね。
テキトー教師DotAI 認定講師初めて触る人がだいたい一度は通る道でして。キーはDeveloperなのに有料系のほうを叩いて認証エラー、みたいな。
エラー文だけ見るとキーが悪いのかと疑っちゃうんですよ。
エラー文だけ見るとキーが悪いのかと疑っちゃうんですよ。
室谷代表取締役翻訳の実行先はパスまで含めて https://api-free.deepl.com/v2/translate と https://api.deepl.com/v2/translate の2つ。プランを上げたらホスト名だけ差し替える、という覚え方でいいと思います。
テキトー教師DotAI 認定講師接続先を環境変数に持たせておくと、切り替えのときにコードを触らずに済みますね。
AuthorizationにDeepL-Auth-Keyを載せる書き方
室谷代表取締役送り方はシンプルで、ヘッダーに1行足すだけです。公式クイックスタートと同じ形を置くとこうなります。
bash
curl https://api-free.deepl.com/v2/translate \
-H "Authorization: DeepL-Auth-Key <APIキー>" \
-H "Content-Type: application/json" \
-d '{"text":["Hello, world!"],"target_lang":"DE"}'
テキトー教師DotAI 認定講師「Authorization」の値に「DeepL-Auth-Key」とキーを半角スペース区切りで、という形なんですね。ここ、コロンを入れてしまったり、Bearerの書き方と混ざったりする人がいます。
室谷代表取締役ヘッダー方式にしておくと、キーがURLにもボディにも残らない。ログに落ちる範囲を減らせるのは、運用する側としては地味に大きいんですよ。
auth_keyをURLに置く古いコード例が危ない理由
室谷代表取締役古いサンプルだと、URLの末尾に認証キーをくっつけてGETで投げる書き方が出てきます。あれ、動きはするんですけど、URLはアクセスログやプロキシのログに残るので。
テキトー教師DotAI 認定講師現場でよく聞くのは「コピペしたコードが動いたからそのまま」というパターンです。動くことと安全なことは別なんですよね。
室谷代表取締役キーが漏れたときの対応は、無効化して再発行、影響範囲の調査…と、地味に人が溶けます。最初からヘッダーで書いておくほうが結果的に安い。
キーの管理まわりはCursor APIキーの完全ガイドでも同じ考え方で整理されているので、あわせて見ておくと分かりやすいです。
キーの管理まわりはCursor APIキーの完全ガイドでも同じ考え方で整理されているので、あわせて見ておくと分かりやすいです。
POST /v2/translateに送る最小のJSONと公式クライアントライブラリ
テキトー教師DotAI 認定講師ボディはJSONで、クイックスタートに載っている最小の形が {"text":["Hello, world!"],"target_lang":"DE"} です。翻訳したい文字列を配列で渡す、という点が最初は戸惑いやすいところで。
室谷代表取締役配列なので複数まとめて投げられる。1回のリクエストで済むなら、呼び出しの無駄も減りますからね。
テキトー教師DotAI 認定講師あと、自分でHTTPを書かなくても公式のクライアントライブラリがあって、Python、JavaScript、PHP、.NET、Java、Rubyは公式が出しています。Dart、Go、Rustあたりはコミュニティ版ですね。
室谷代表取締役使う言語に合うなら素直にライブラリを使う。認証ヘッダーの付け方まで吸収してくれるので、そこに時間をかけないほうがいいと思います。
ファイル翻訳の手順と、思わぬ請求を防ぐ文字数カウントの話
文書翻訳はアップロード→状態確認→結果取得の3ステップ
室谷代表取締役テキスト翻訳は1回POSTすれば返ってくるんですけど、ファイルをまるごと翻訳しようとすると話が変わってくるんですよね。
テキトー教師DotAI 認定講師そうなんですよ。結果がすぐ返ってこないので、初めて触る人は「あれ、失敗したのかな」と感じるみたいです。
手順としてはこうなります。
手順としてはこうなります。
POST /v2/documentでファイルをアップロードする- ドキュメントIDを使ってステータスを確認する
- 完了後に
/resultから結果ファイルを取得する
室谷代表取締役要は非同期なんですね。ジョブを投げて、終わるのを待つ、と。
テキトー教師DotAI 認定講師はい。待ち時間の確認間隔を詰めすぎるとリクエストだけ無駄に増えるので、そこは余裕を持たせたほうが現場では事故りにくいです。
課金対象の文字数はどう数えられているか
室谷代表取締役ここからが料金の話で、一番見落とされる部分なんですけど・・・文字数ってどこを数えてるんですか。
テキトー教師DotAI 認定講師原文ベースです。翻訳後の文章ではなく、送った側のテキストがUnicodeコードポイント単位で数えられて、空白もタブも改行も1文字としてカウントされます。
室谷代表取締役じゃあ整形したJSONをそのまま投げると、その余白の分まで課金対象になり得るわけですね。地味に効いてくるやつだ。
テキトー教師DotAI 認定講師そうなんです。あと
HTMLをまるごと翻訳したいときは、そこを設定するかどうかで差が出ますね。
tag_handling を xml か html にしておくと、タグそのものや属性は課金対象から外れます。HTMLをまるごと翻訳したいときは、そこを設定するかどうかで差が出ますね。
ファイル形式ごとの最低課金とアップロード上限
室谷代表取締役最低課金の話、ここが一番の罠なんですよ。
テキトー教師DotAI 認定講師Word、PowerPoint、Excel、PDFは、1ファイルにつき最低50,000文字分が課金されます。中身が数百文字しかなくても、です。
室谷代表取締役1行だけの議事録docxを大量に投げる、みたいな使い方をすると請求が跳ねるわけですね。うちでも新しいAPIを入れるときは、まず上限を決めてから本番に流すようにしてます。
テキトー教師DotAI 認定講師HTML、SRT、テキスト、XLIFFには下限がなくて正確にカウントされるので、その差がまた分かりにくいんですよ。アップロードできる量は無料プランだと最大10MB・50万文字、有料プランは形式によって最大100MB・500万文字までです。
使いすぎを防ぐ月間上限の設定手順
室谷代表取締役本番投入の前に、上限だけは先に決めておくべきなんですよね。
テキトー教師DotAI 認定講師設定できるのはGrowth以降の契約者です。順番としてはこうです。
- DeepLアカウントにログインする
- 「アカウント」から「APIキーと制限」タブを開く
- サブスクリプション単位の月間料金上限(コストコントロール)を設定する
- APIキー単位で、月間の文字数・音声分数の上限を設定する
- 音声テキスト化を使う場合は、その月間上限もあわせて設定する
室谷代表取締役上限に達すると、その請求期間が終わるまで追加の翻訳リクエストが処理されない。サービスが止まるのは痛いですけど、青天井よりははるかにマシなんですよね。
テキトー教師DotAI 認定講師よくある質問
Q1. 対応している言語はどれくらいある?
テキトー教師DotAI 認定講師現場でよく聞くのが「英語以外もいけますか」なんですよね。日本語から中国語や韓国語への翻訳を想定している人も多いです。
室谷代表取締役そこは公式の対応言語一覧を見るのが確実なんですよ。言語の組み合わせによって仕上がりの当たり外れがあるので、自社の文例で一度試すのが早い・・・
テキトー教師DotAI 認定講師たしかに。対応しているかどうかと、実務で使える品質かどうかは別の話ですからね。
Q2. 社名や専門用語の訳を固定できる?
室谷代表取締役固有名詞が毎回違う訳になるの、地味に困るんですよね。表記ゆれがそのまま納品物に出てくるので。
テキトー教師DotAI 認定講師初めて触る人はだいたいここで詰まります。訳語を固定する仕組みが用意されているか、公式の機能一覧を先に見ておくといいですよ。
室谷代表取締役あとは自社側で置換ルールを挟む前提で設計しておくと、後からぐっと楽なんですよね。
Q3. 商用利用やアプリへの組み込みは問題ない?
テキトー教師DotAI 認定講師「自社サービスに組み込んでいいのか」というのは現場でよく出る質問です。規約まわりは公式の利用規約を確認するのが一番ですね。
室谷代表取締役ここは感覚で判断しないほうがいいんですよね。契約前に法務か誰かが一回目を通す、それだけで事故が減ります。
テキトー教師DotAI 認定講師たしかに。あとから「そんなつもりじゃ」になるのが一番怖いので。
Q4. 機密情報を送るのが心配。何を確認すればいい?
室谷代表取締役顧客データをそのまま投げるのは、経営判断として一回止めたほうがいいんですよね。誰が何を送ったか把握できていない状態が一番まずい。
テキトー教師DotAI 認定講師現場感覚で言うと、先に「送っていい情報」と「だめな情報」を決めてから実装に入る順番が安全です。
室谷代表取締役データの取り扱いは公式のポリシー記載を見て、社内ルールと突き合わせる。ここを飛ばすと後で説明できなくなる・・・
Q5. 他の翻訳サービスと比べて、どう使い分ければいい?
テキトー教師DotAI 認定講師比較記事だけ読んで決めようとする人、多いんですよ。でも結局は自分の文章で試した結果がすべてで。
室谷代表取締役比較は一度やれば終わりじゃないんですよね。同じ文面をいくつか投げて、自然さとコストを見比べる。
切り替えられるように実装しておけば、選定を間違えても致命傷にならないですし。
切り替えられるように実装しておけば、選定を間違えても致命傷にならないですし。
まとめ
室谷代表取締役最初にやることはシンプルなんですよね。登録してキーを1本発行して、自分の文章を数十行投げてみる。
そこで品質と文字数の感覚が掴めます。
そこで品質と文字数の感覚が掴めます。
テキトー教師DotAI 認定講師たしかに。いきなり大きな契約をするより、無料の範囲で「うちの文章だとどう出るか」を見たほうが判断が早いです。
室谷代表取締役上限がリセットされない仕様なので、使い切ったら有料プランに切り替える前提で計画を立てる。時給で換算すると、試すのにかかる時間なんて誤差みたいなものですし。
テキトー教師DotAI 認定講師現場でよく聞くのは「本番投入の前に、文字数を数える仕組みだけは先に作る」という話ですね。あとから請求を見て驚くパターンを避けられます。
室谷代表取締役まずは1リクエスト通すところから。そこで分かることは、記事を10本読むより多いですよ。
