What is Azure Text Translation?

Artikkel
12/11/2023

Azure Text Translation is a cloud-based REST API feature of the Translator service that uses neural machine translation technology to enable quick and accurate source-to-target text translation in real time across all supported languages. In this overview, you learn how the Text Translation REST APIs enable you to build intelligent solutions for your applications and workflows.

Text translation documentation contains the following article types:

Quickstarts. Getting-started instructions to guide you through making requests to the service.
How-to guides. Instructions for accessing and using the service in more specific or customized ways.
Reference articles. REST API documentation and programming language-based content.

Text translation features

Text Translation supports the following methods:

Languages. Returns a list of languages supported by Translate, Transliterate, and Dictionary Lookup operations. This request doesn't require authentication; just copy and paste the following GET request into Postman or your favorite API tool or browser:
```
https://api.cognitive.microsofttranslator.com/languages?api-version=3.0
```
Translate. Renders single source-language text to multiple target-language texts with a single request.
Transliterate. Converts characters or letters of a source language to the corresponding characters or letters of a target language.
Detect. Returns the source code language code and a boolean variable denoting whether the detected language is supported for text translation and transliteration.

Note

You can Translate, Transliterate, and Detect text with a single REST API call .
Dictionary lookup. Returns equivalent words for the source term in the target language.
Dictionary example Returns grammatical structure and context examples for the source term and target term pair.

Text translation deployment options

Add Text Translation to your projects and applications using the following resources:

Access the cloud-based Translator service via the REST API, available in Azure.
Use the REST API translate request with the Text translation Docker container.
Important
- To use the Translator container you must complete and submit the Azure AI services application for Gated Services online request form and have it approved to acquire access to the container.
- The Translator container image supports limited features compared to cloud offerings.

Data residency

Text Translation data residency depends on the Azure region where your Translator resource was created:

Translator resources created in any region in Europe are processed at data center in West Europe and North Europe.
Translator resources created in any region in Asia or Australia are processed at data center in Southeast Asia and Australia East.
Translator resource created in all other regions including Global, North America and South America are processed at data center in East US and West US 2.

Text Translation data residency

✔️ Feature: Translator Text
✔️ Region where resource created: Any

Service endpoint	Request processing data center
Global (recommended): `api.cognitive.microsofttranslator.com`	Closest available data center.
Americas: `api-nam.cognitive.microsofttranslator.com`	East US • South Central US • West Central US • West US 2
Europe: `api-eur.cognitive.microsofttranslator.com`	North Europe • West Europe
Asia Pacific: `api-apc.cognitive.microsofttranslator.com`	Korea South • Japan East • Southeast Asia • Australia East

Get started with Text Translation

Ready to begin?

Create a Translator resource in the Azure portal.
Get your access keys and API endpoint. An endpoint URL and read-only key are required for authentication.
Explore our Quickstart and view use cases and code samples for the following programming languages:

Next steps

Dive deeper into the Text Translation REST API:

See the REST API reference