Microsoft Translator

Use this dialog to configure Microsoft Translator.

Account

Microsoft Translator is a free service of up to 2 million characters per month. If you use more, you have to pay. Even if you use only a little, you have to get your own personal account. Key specifies the user account that the Microsoft Translator uses. If you have used Custom Translator to train Microsoft Translator, enter your category id in the Category ID field. Click the Test account button to perform a test that makes sure that your account works correctly.

If you don't have an existing account or want to make a new account check, I don't have an account or create a new one checkbox. When checked, the dialog will show an extra button:Click Get account button to go to subscribe to Microsoft Translator (steps 1, 2, and 3).

Go to Azure portal.
Select + Create a resource.
In the Search the Marketplace search box, enter Translator and then select Translator from the results.
Select Create to define details for the subscription.
From the Pricing tier list, select the pricing tier that best fits your needs.
- Each subscription has a free tier. The free tier has the same features and functionalities as the paid plans and doesn't expire.
- You can have only one free subscription for your account.
- In the Pricing Tier section, select the pricing tier that fits your needs. If 2 million characters per month are enough for you, select the F0 Free tier. This subscription is free. If you need more, then select the tier matching your needs.
Select Review + create to review the subscription.
Select Create to finish creating the subscription.

Got to the resource you just created.

Select Keys and Endpoint.
Write down or copy your key (KEY 1). Once you have it, enter it into the corresponding Key edit field in this dialog.

The Azure resource pages has a Text Translation field under the Web API section. Do not use that endpoint. Instead use the following endpoint.

Endpoint

Endpoint edit specifies the endpoint where the access token is acquired. The format depends on your translator resources.

Free version

If you use the free version the format is

https://<your-region>.api.cognitive.microsoft.com/sts/v1.0/issueToken

Replace region with the region code where you translator resource is located. For example if you region is West US 2 use

https://westus2.api.cognitive.microsoft.com/sts/v1.0/issueToken

You can see the list of available Azure region name here.

Paid version

If you have your own custom domain (i.e. paid version), use the following format.

https://<service-name>.cognitiveservices.azure.com/sts/v1.0/issuetoken

Replace the service name with the name of your Translator resource. For example, if your resource name is MyTranslator, use

https://mytranslator.cognitiveservices.azure.com/sts/v1.0/issuetoken

Caregory ID

You can specify an optional property for the machine translator in the Category field, such as an instruction to use your own custom MT model.

Supported languages

This group shows the list of languages that Microsoft Translator supports.