Azure Text Translation は Translator サービスのクラウドベースの REST API 機能であり、ニューラル機械翻訳テクノロジを使用して、 サポートされているすべての言語で迅速かつ正確なソースからターゲットへのテキスト翻訳をリアルタイムで有効にします。 この概要では、テキスト翻訳 REST API を使用して、アプリケーションとワークフローのインテリジェントなソリューションを構築する方法について説明します。
テキスト翻訳のドキュメントには、次の記事の種類が含まれています。
- クイック スタート。 サービスへの要求を行う手順を説明する作業の開始手順。
- ハウツー ガイド。 より具体的な方法またはカスタマイズされた方法でサービスにアクセスして使用するための手順。
- リファレンス記事。 REST API のドキュメントとプログラミング言語ベースのコンテンツ。
テキスト翻訳機能
最新のプレビュー リリースでは、必要に応じて標準ニューラル マシン (NMT) 翻訳または大規模言語モデル (LLM) デプロイ (GPT-4o-mini または GPT-4o) を選択できるようになりました。 ただし、LLM モデルを使用するには、Azure AI Foundry リソースが必要です。 詳細については、Azure リソースの構成 に関するページを参照してください。
言語。 Translate API と Transliterate API でサポートされている言語の一覧を返します。 この要求には認証は必要ありません。次の
GET要求をコピーして、任意の REST API ツールまたはブラウザーに貼り付けるだけです。https://api.cognitive.microsofttranslator.com/languages?api-version=2025-05-01-preview翻訳します。 単一の
POST要求を使用して、単一のソース言語テキストを複数のターゲット言語テキストにレンダリングします。表記変換を行います。 ソース言語の文字または文字を、1 つの
POST要求でターゲット言語の対応する文字または文字に変換します。
テキスト翻訳の展開オプション
次のリソースを使用して、プロジェクトとアプリケーションにテキスト翻訳を追加します。
Azure で利用できる REST API を使用して、クラウドベースの Translator サービスにアクセスします。
テキスト変換 Docker コンテナーで REST API 翻訳要求を使用します。
Important
Translator コンテナーを使用するには、コンテナーへのアクセスを承認するために、 Gated Services オンライン要求フォームの Azure AI サービス アプリケーション を完了して送信する必要があります。
Translator コンテナー イメージは、クラウド オファリングと比較して限られた機能をサポートします。
データの保存場所
テキスト翻訳データの保存場所は、Translator リソースが作成された Azure リージョンによって異なります。
テキスト翻訳データの保存場所
✔️ 機能: Translator Text
| サービス エンドポイント | 要求処理データ センター |
|---|---|
グローバル (推奨):api.cognitive.microsofttranslator.com |
使用可能な最も近いデータ センター。 |
アメリカ大陸:api-nam.cognitive.microsofttranslator.com |
米国東部 2 • 米国西部 2 |
アジア太平洋:api-apc.cognitive.microsofttranslator.com |
東日本 • 東南アジア |
ヨーロッパ (スイスを除く):api-eur.cognitive.microsofttranslator.com |
フランス中部 • 西ヨーロッパ |
|
スイス: 詳細については、「スイスのサービス エンドポイント」を参照してください。 |
スイス北部 • スイス西部 |
スイスのサービス エンドポイント
スイス北部またはスイス西部にリソースを持つお客様は、Text API 要求がスイス内で確実に処理されるようにすることができます。 スイスで要求が確実に処理されるようにするには、 Resource regionSwitzerland North または Switzerland Westで Translator リソースを作成し、API 要求でリソースのカスタム エンドポイントを使用します。
たとえば、 Resource region を Switzerland North として Azure portal で Translator リソースを作成し、リソース名を my-swiss-nした場合、カスタム エンドポイントは https​://my-swiss-n.cognitiveservices.azure.com。 翻訳する要求の例は次のとおりです。
// Pass secret key and region using headers to a custom endpoint
curl -X POST "https://my-swiss-n.cognitiveservices.azure.com/translator/text/v3.0/translate?to=fr" \
-H "Ocp-Apim-Subscription-Key: xxx" \
-H "Ocp-Apim-Subscription-Region: switzerlandnorth" \
-H "Content-Type: application/json" \
-d "[{'Text':'Hello'}]" -v
現在、カスタム翻訳ツールはスイスでは使用できません。
テキスト翻訳の概要
開始する準備はできましたか?
Translator リソースを作成する Azure portal で を選択します。
アクセス キーと API エンドポイントを取得します。 認証には、エンドポイント URL と読み取り専用キーが必要です。
クイック スタート「REST と推奨されるプログラミング言語を使用して Translator を使用する方法について説明します」を参照してください)。次のプログラミング言語のユース ケースとコード サンプルを表示します。
次のステップ
テキスト翻訳 REST API の詳細を確認します。