Cloud Translation API の概要
Cloud Translation API では、100 以上の言語ペアのテキストを翻訳できます。原文テキストの言語がわからない場合でも、Cloud Translation API で検出できます。サポートされている言語の一覧については、サポートされている言語をご覧ください。
企業組織では、既存の内部ワークフローに翻訳版テキストを含めることができます。たとえば、グローバルなサポートチームで、さまざまな言語のお客様のケースを受け入れているとします。このワークフローに Cloud Translation API を追加すると、お客様のケースをサポートチーム メンバーが話す言語に翻訳できます。Cloud Translation API を使用することで、テキストを手動で翻訳する必要や、他者に依頼する必要がなくなるため、サポートチームの全体的な効率が向上します。
Cloud Translation API はシームレスにスケーリングできるため、1 日あたりの翻訳文字数に上限はありません。ただし、リクエストごとおよびリクエスト率ごとのコンテンツ サイズには制限があります。また、割り当て上限を使用して予算を管理することもできます。詳細については、割り当てと上限をご覧ください。
Cloud Translation API には、Basic エディションと Advanced エディションの 2 つのエディションがあります。各エディションでサポートされているさまざまな機能の一覧については、エディションの比較をご覧ください。
Cloud Translation - Basic API
Basic エディションは v2 クライアント ライブラリを介してアクセスでき、構成は最小限で済みます。認証用の API キーとサービス アカウントを受け入れ、Google の事前トレーニング済みニューラル機械翻訳（NMT）モデルを修正なしで使用します。チャット、ソーシャル メディア、コメントなど、形式張らないユーザー作成コンテンツの翻訳が必要なアプリケーションに適しています。
デフォルトでは、Cloud Translation API は Basic エディションを使用します。このエディションは、より多くのトレーニング データやより良い手法が利用可能になると、Google によってほぼ定期的な間隔で更新されています。
ただし、新しいプロジェクトを計画している場合は、Advanced エディションを選択して、セキュリティの強化、機能の追加、Advanced エディションで今後も継続的に行われる新しいサービス改善点を活用することをおすすめします。
Cloud Translation - Advanced API
Advanced エディションには v3 クライアント ライブラリを介してアクセスします。また、IAM ロールと統合されたサービス アカウント認証が必要です。Translation LLM モデル、NMT モデル、NMT カスタマイズなど、モデルを選択できます。また、用語集、一括翻訳、ドキュメント翻訳などの機能も提供します。
Cloud Translation - Advanced API の主な機能は次のとおりです。
より多くのモデルへのアクセス - 翻訳 LLM、Google のニューラル機械翻訳（NMT）モデル、適応型翻訳モデル、作成したカスタム NMT モデルなど、最先端の翻訳モデルの中から最適なモデルを選択できます。
用語集 - カスタム辞書を作成して、分野固有の用語を正確に一貫性を保持しつつ翻訳できます。
バッチ リクエスト - 非同期リクエストを行い、大量のテキストを翻訳します。
Document Translation - PDF ファイルなどのドキュメントを翻訳し、元の書式とレイアウトを維持します。
IAM ロール - Identity and Access Management を使用して翻訳リクエストを保護します。サービス アカウントを作成し、IAM のロールを追加して権限を付与する。Cloud Translation - Advanced API では API キーはサポートされていません。
ラベル - ユーザー定義のラベル（Key-Value ペア）を翻訳リクエストに追加すると、使用状況を追跡しやすくなり、詳細な請求レポートを取得できます。
リージョン エンドポイント - プロジェクトのリソースが保存、処理される場所を管理、制御します。
用語集
用語集は、ドメイン固有の用語、名前付きエンティティ、お客様特有のその他の種類の用語を正確に一貫した翻訳にするために Cloud Translation - Advanced API が使用するカスタム辞書です。たとえば、用語集を使用して「Google Summer of Code」、「Gmail confidential mode」、「placement performance report」などの用語に特定の翻訳を指定できます。
借用語やプロダクト名などの特定の単語が翻訳されないように、用語集を使用することもできます。用語集の使用方法については、用語集の作成と使用をご覧ください。
バッチ リクエスト
一括翻訳リクエストは、Cloud Storage バケットから入力を変換する非同期リクエストです。Cloud Translation - Advanced API は一括翻訳を長時間実行オペレーションとして実行し、指定した Cloud Storage バケットに出力を書き込みます。一括翻訳のインライン リクエストはサポートされていません。
一括リクエストの実行については、一括リクエスト（Advanced）をご覧ください。
Document Translation
Document Translation を使用すると、PDF や DOCX ファイルなどの既存のドキュメントをターゲット言語に直接翻訳できます。Document Translation では、翻訳されたドキュメントのレイアウトと形式が、元のドキュメントと同じになるように元の形式が維持されます。たとえば、Document Translation では、翻訳されたコンテンツは元のドキュメントと同様に分割され、段落の区切りと見出しが維持されます。
Cloud Translation - 用語集や AutoML モデルなどの高度な API 機能も Document Translation で動作します。たとえば、テキスト翻訳に使用する既存の AutoML モデルがある場合、Document Translation にも同じモデルを使用できます。サポートされているファイル形式やドキュメントの翻訳方法について詳しくは、ドキュメントを翻訳するをご覧ください。
モデル選択と AutoML モデル
Cloud Translation - Advanced API のモデル選択を使用すると、翻訳するコンテキストとコンテンツに応じて、Translation LLM（適応型翻訳用にさらにカスタマイズすることも可能）、Google の NMT モデル、カスタム AutoML Translation モデルの中から、アプリケーションに最適なモデルを動的に選択できます。
AutoML Translation を使用してカスタムモデルを作成すると、分野固有の用語をより正確に翻訳できます。作成されたモデルを使用して、Cloud Translation - Advanced API でテキストを翻訳できます。
カスタムモデルを使用したテキストの翻訳については、テキストの翻訳（Advanced）をご覧ください。
IAM ロール
Cloud Translation - Advanced API は、IAM と統合することで翻訳リクエストのセキュリティを強化し、きめ細かなアクセス制御を実現して、AutoML Translation との統合もサポートします。
次のいずれかのロールにユーザーとサービス アカウントを追加して、Cloud Translation - Advanced API へのアクセス権を付与する必要があります。サービス アカウントの作成方法については、IAM ドキュメントのサービス アカウントの作成と管理をご覧ください。
| ロール | 役割 ID | 説明 |
|---|---|---|
| Cloud Translation API 閲覧者 | roles/cloudtranslate.viewer |
取得オペレーションとリスト オペレーションが利用できます。 |
| Cloud Translation API ユーザー | roles/cloudtranslate.user |
|
| Cloud Translation API 編集者 | roles/cloudtranslate.editor |
|
| Cloud Translation API 管理者 | roles/cloudtranslate.admin |
|
各ロールに含まれる権限のリストについては、ロールについてをご覧ください。
一般的なユースケースの多くには、これらの事前構成されたロールで対応できます。ただし、権限のカスタムセットが含まれたロールが必要になる場合もあります。たとえば、プロジェクトの既存の用語集を削除または更新せずに、プロジェクトに新しい用語集を作成できるようにロールを作成し、ユーザーに付与できます。そのような場合には、ニーズを満たす IAM カスタムロールを作成できます。
IAM ロールの管理については、リソースに対するアクセス権の付与、変更、取り消しとサービス アカウントへのロールの付与をご覧ください。
ラベル
Cloud Translation - Advanced API では、TranslateText、BatchTranslateText、DetectLanguage リクエストにユーザー定義ラベル（Key-Value ペア）を追加できます。リクエストの使用状況に関する情報は、課金システムに転送されます。そこでは、ラベルを基準にしてフィルタリングし、請求料金を分類できます。
ユーザー定義ラベルの詳細については、ラベル付き使用状況の報告（Advanced）をご覧ください。
リージョン エンドポイント
デフォルトでは、Cloud Translation - Advanced API はグローバル ロケーションにリソースを保存し、処理します。つまり、リソースが特定のロケーションに残る保証はありません。デフォルトのグローバル エンドポイントを使用する代わりに、リージョン エンドポイントを使用して、EU などの特定のロケーション内にリソースを保持できます。詳細については、リージョン エンドポイントを指定するをご覧ください。
エディションの比較
次の表は、各エディションで利用できる機能を示したものです。
| 機能 | 基本 | 高度 |
|---|---|---|
| NMT モデルを使用した翻訳 | ||
| 翻訳 LLM を使用した翻訳 | ||
| 適応型翻訳モデルを使用した翻訳 | ||
| カスタムモデルを使用した翻訳 | ||
| 1 つのリクエストでの複数の文字列の翻訳 | ||
| Cloud Storage を使用した一括翻訳 | ||
| ドキュメントの翻訳 | ||
| 用語集のサポート（用語の管理） | ||
| カスタムモデルのトレーニング | ||
| 言語の検出 | ||
| 統合された REST API | ||
| 統合された gRPC API | ||
| サービス アカウント | ||
| API キー | ||
| 監査ロギング | ||
| HTML のサポート | ||
| 100 以上の言語のサポート | ||
| ローマ字表記のサポート | ||
| 文字変換のサポート | ||
| 適応型翻訳 | ||
| マルチリージョン エンドポイントのサポート | ||
| VPC Service Controls のサポート |
Cloud Translation - Advanced API の詳細については、Cloud Translation - Advanced API の機能をご覧ください。
料金
Cloud Translation API の料金は、送信した文字数に基づいて月単位で請求されます。詳細は、料金をご覧ください。
リソースと関連情報
- API の使用を開始するには、設定を行ってから、クイックスタート ガイドをお試しください。
- サポートされているモデルを比較する
- NMT モデルをカスタマイズする
- 翻訳 LLM をカスタマイズする
- サポートされている言語
- サポートされている形式
- 適応型翻訳を実行する
- Translation Advanced に移行する
- Cloud Translation API に関する一般的な質問については、よくある質問のページをご覧ください。