次の方法で共有

Foundry Tools v3.0 のAzure Translator

最近のニュースは何ですか?

Translator のバージョン 3.0 には、最新の JSON ベースの Web API が用意されています。 既存の機能をより少ない操作に統合することで、使いやすさとパフォーマンスが向上し、新機能が提供されます。

  • ある言語のテキストをあるスクリプトから別のスクリプトに変換する表記変換。
  • 1 つの要求で複数の言語に翻訳します。
  • 1 つの要求での言語検出、翻訳、表記変換。
  • 用語の代替翻訳を検索し、コンテキストで使用される用語を示すバック翻訳と例を検索する辞書。
  • より有益な言語検出結果。

ベース URL

Translator への要求は、ほとんどの場合、要求が発生した場所に最も近いデータセンターによって処理されます。 グローバル エンドポイントの使用時にデータセンターの障害が発生した場合、要求が地理的な外部にルーティングされる可能性があります。

特定の地域内で要求を強制的に処理するには、目的の地理的エンドポイントを使用します。 すべての要求は、地域内のデータセンター間で処理されます。

✔️ 機能: 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 要求でリソースのカスタム エンドポイントを使用します。

たとえば、Azure ポータルで Resource regionSwitzerland North として 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

カスタム翻訳ツールは、現在スイスでは使用できません。

Virtual Networkサポート

Translator は、Azure パブリック クラウドのすべてのリージョンでVirtual Network (VNET) 機能を使用できるようになりました。 Virtual Networkを有効にするには、Foundry Tools 仮想ネットワークの構成<>See。

この機能を有効にしたら、カスタム エンドポイントを使用して Translator を呼び出す必要があります。 グローバル トランスレーター エンドポイント ("api.cognitive.microsofttranslator.com") を使用することはできません。また、アクセス トークンで認証することはできません。

Translator リソースを作成し、選択したネットワークとプライベート エンドポイントからのアクセスを許可した後で、カスタム エンドポイントを見つけることができます。

  1. Azure ポータルで Translator リソースに移動します。

  2. [リソース管理] セクションで [ネットワーク] を選択します。

  3. [ファイアウォールと仮想ネットワーク] タブで、[選択したネットワークとプライベート エンドポイント] を選択します。

    Azure portal.

  4. [保存] を選択して変更を保存します。

  5. [リソース管理] セクションから [キーとエンドポイント] を選択します。

  6. Virtual Network タブを選択します。

  7. テキスト翻訳とドキュメント翻訳のエンドポイントが一覧表示されます。

    仮想ネットワーク エンドポイントのスクリーンショット。

ヘッダー 説明
Ocp-Apim-Subscription-Key 値は、Translator へのサブスクリプションのAzure秘密鍵です。
Ocp-Apim-Subscription-Region 値は、Translator リソースのリージョンです。 この値は、リソースが global

カスタム エンドポイントを使用して Translator を呼び出す要求の例を次に示します。

// Pass secret key and region using headers
curl -X POST "https://<your-custom-domain>.cognitiveservices.azure.com/translator/text/v3.0/translate?api-version=3.0&to=es" \
     -H "Ocp-Apim-Subscription-Key:<your-key>" \
     -H "Ocp-Apim-Subscription-Region:<your-region>" \
     -H "Content-Type: application/json" \
     -d "[{'Text':'Hello, what is your name?'}]"

メトリック

メトリックを使用すると、Azureポータルで Translator の使用状況と可用性の情報を表示できます。 詳細については、「 データとプラットフォームのメトリック」を参照してください。

Translator メトリック

次の表は、利用可能なメトリックと、翻訳 API 呼び出しを監視するために使用される方法の説明を示しています。

メトリック 説明
TotalCalls API 呼び出しの合計数。
TotalTokenCalls 認証トークンを使用したトークン サービス経由の API 呼び出しの合計数。
SuccessfulCalls 成功した呼び出しの数。
TotalErrors エラー応答を含む呼び出しの数。
BlockedCalls レートまたはクォータの制限を超えた呼び出しの回数。
ServerErrors サーバー内部エラー (5XX) を含む呼び出しの数。
ClientErrors クライアント側エラー (4XX) を含む呼び出しの数。
遅延 要求を完了するまでの時間 (ミリ秒単位)。
CharactersTranslated 受信テキスト要求の合計文字数。
  • Last updated on