Azure Translator in Foundry Tools v3.0

What's new?

Version 3.0 of the Translator provides a modern JSON-based Web API. It improves usability and performance by consolidating existing features into fewer operations and it provides new features.

• Transliteration to convert text in one language from one script to another script.
• Translation to multiple languages in one request.
• Language detection, translation, and transliteration in one request.
• Dictionary to look up alternative translations of a term, to find back-translations and examples showing terms used in context.
• More informative language detection results.

Base URLs

The global base URL is https://api.cognitive.microsofttranslator.com. Text translation also supports geography and resource-specific endpoints. For all endpoint URLs and their request processing locations, see Region support for Azure Translator.

Virtual Network support

The Translator is now available with Virtual Network (VNET) capabilities in all regions of the Azure public cloud. To enable Virtual Network, See Configuring Foundry Tools virtual networks.

Once you turn on this capability, you must use the custom endpoint to call the Translator. You can't use the global translator endpoint ("api.cognitive.microsofttranslator.com") and you can't authenticate with an access token.

You can find the custom endpoint after you create a translator resource and allow access from selected networks and private endpoints.

1. Navigate to your Translator resource in the Azure portal.

2. Select Networking from the Resource Management section.

3. Under the Firewalls and virtual networks tab, choose Selected Networks and Private Endpoints.

   

4. Select Save to apply your changes.

5. Select Keys and Endpoint from the Resource Management section.

6. Select the Virtual Network tab.

7. Listed there are the endpoints for Text translation and Document translation.

   

Here's an example request to call the Translator using the custom endpoint

// 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?'}]"

Metrics

Metrics allow you to view the translator usage and availability information in Azure portal. For more information, see Data and platform metrics.

This table lists available metrics with description of how they're used to monitor translation API calls.