Foundry Tools の Azure Translator は、ニューラル機械翻訳テクノロジを使用して、 サポートされているすべての言語でソースからターゲットへのテキスト翻訳をリアルタイムで迅速かつ正確に実現する Translator のクラウドベースの REST API 機能です。 この概要では、テキスト翻訳 REST API を使用して、アプリケーションとワークフローのインテリジェントなソリューションを構築する方法について説明します。
テキスト翻訳のドキュメントには、次の記事の種類が含まれています。
- クイック スタート。 サービスへの要求を行う手順を説明する作業の開始手順。
- ハウツー ガイド。 より具体的な方法またはカスタマイズされた方法でサービスにアクセスして使用するための手順。
- リファレンス記事。 REST API のドキュメントとプログラミング言語ベースのコンテンツ。
テキスト翻訳機能
最新のプレビュー リリースでは、必要に応じて標準ニューラル機械翻訳 (NMT) または大規模言語モデル (LLM) デプロイ (GPT-4o-mini または GPT-4o) を選択できるようになりました。 ただし、LLM モデルを使用するには、Microsoft Foundry リソースが必要です。 詳細については、Azure リソースの構成 に関するページを参照してください。
言語。 Translate API と Transliterate API でサポートされている言語の一覧を返します。 この要求には認証は必要ありません。次の
GET要求をコピーして、任意の REST API ツールまたはブラウザーに貼り付けるだけです。https://api.cognitive.microsofttranslator.com/languages?api-version=2025-10-01-preview翻訳します。 単一の
POST要求を使用して、単一のソース言語テキストを複数のターゲット言語テキストにレンダリングします。表記変換を行います。 ソース言語の文字または文字を、1 つの
POST要求でターゲット言語の対応する文字または文字に変換します。
テキスト翻訳の開発オプション
次のリソースを使用して、プロジェクトとアプリケーションにテキスト翻訳を追加します。
| 開発オプション | Description |
|---|---|
| ファウンドリ | • Foundry (クラシック) ポータル は、ハブベースのプロジェクトやその他のリソースの種類をサポートするクラウドベース の AI プラットフォームです。 •Foundry (新しい) ポータル は、 Foundry プロジェクトを通じて Foundry のモデル、エージェント、ツールに効率的にアクセスできるクラウドベースの AI プラットフォームです。 |
| REST API | REST API (GA) バージョンまたは REST API (プレビュー) バージョンを使用して、アプリケーションに翻訳を統合します。 |
| クライアント ライブラリ (SDK) | さまざまなプログラミング言語で利用可能な クライアント ライブラリ (SDK) のいずれかを使用して、翻訳機能をアプリケーションに統合します。 |
| Docker コンテナー | • Translator コンテナーを使用するには、コンテナーへのアクセス承認を受けるために、Gated Services用のFoundry Tools申請書をオンライン要求フォームで完了し、提出する必要があります。 • 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 の詳細を確認します。