Create a Translator resource

In this article, you learn how to create a Translator resource in the Azure portal. Azure Translator is a cloud-based machine translation service that is part of the Azure Cognitive Services family of REST APIs. Azure resources are instances of services that you create. All API requests to Azure services require an endpoint URL and a read-only key for authenticating access.

Prerequisites

To get started, you need an active Azure account. If you don't have one, you can create a free 12-month subscription.

Create your resource

The Translator service can be accessed through two different resource types:

  • Single-service resource types enable access to a single service API key and endpoint.

  • Multi-service resource types enable access to multiple Cognitive Services using a single API key and endpoint.

Complete your project and instance details

  1. Subscription. Select one of your available Azure subscriptions.

  2. Resource Group. You can create a new resource group or add your resource to a pre-existing resource group that shares the same lifecycle, permissions, and policies.

  3. Resource Region. Choose Global unless your business or application requires a specific region. If you're planning on using the Document Translation feature with managed identity authorization, choose a geographic region such as East US.

  4. Name. Enter the name you have chosen for your resource. The name you choose must be unique within Azure.

    Note

    If you are using a Translator feature that requires a custom domain endpoint, such as Document Translation, the value that you enter in the Name field will be the custom domain name parameter for the endpoint.

  5. Pricing tier. Select a pricing tier that meets your needs:

    • Each subscription has a free tier.
    • The free tier has the same features and functionality as the paid plans and doesn't expire.
    • Only one free tier is available per subscription.
    • Document Translation isn't supported in the free tier. Select Standard S1 to try that feature.
  6. If you've created a multi-service resource, you need to confirm more usage details via the check boxes.

  7. Select Review + Create.

  8. Review the service terms and select Create to deploy your resource.

  9. After your resource has successfully deployed, select Go to resource.

Authentication keys and endpoint URL

All Cognitive Services API requests require an endpoint URL and a read-only key for authentication.

  • Authentication keys. Your key is a unique string that is passed on every request to the Translation service. You can pass your key through a query-string parameter or by specifying it in the HTTP request header.

  • Endpoint URL. Use the Global endpoint in your API request unless you need a specific Azure region or custom endpoint. See Base URLs. The Global endpoint URL is api.cognitive.microsofttranslator.com.

Get your authentication keys and endpoint

  1. After your new resource deploys, select Go to resource or navigate directly to your resource page.
  2. In the left rail, under Resource Management, select Keys and Endpoint.
  3. Copy and paste your keys and endpoint URL in a convenient location, such as Microsoft Notepad.

Get key and endpoint.

How to delete a resource or resource group

Warning

Deleting a resource group also deletes all resources contained in the group.

To remove a Cognitive Services or Translator resource, you can delete the resource or delete the resource group.

To delete the resource:

  1. Navigate to your Resource Group in the Azure portal.
  2. Select the resources to be deleted by selecting the adjacent check box.
  3. Select Delete from the top menu near the right edge.
  4. Type yes in the Deleted Resources dialog box.
  5. Select Delete.

To delete the resource group:

  1. Navigate to your Resource Group in the Azure portal.
  2. Select the Delete resource group from the top menu bar near the left edge.
  3. Confirm the deletion request by entering the resource group name and selecting Delete.

How to get started with Translator

In our quickstart, you learn how to use the Translator service with REST APIs.

More resources