O que é a Tradução de Texto do Azure?

2025-04-10

A Tradução de Texto do Azure é uma funcionalidade da API REST baseada na nuvem do serviço Translator que utiliza a tecnologia de tradução automática neural para permitir a tradução rápida e precisa de texto de origem para destino em tempo real em todos os idiomas suportados. Nesta visão geral, você aprenderá como as APIs REST de tradução de texto permitem que você crie soluções inteligentes para seus aplicativos e fluxos de trabalho.

A documentação de tradução de texto contém os seguintes tipos de artigo:

Inícios rápidos. Instruções de introdução para guiá-lo ao fazer solicitações ao serviço.
Guias de utilização. Instruções para aceder e utilizar o serviço de formas mais específicas ou personalizadas.
Artigos de referência. Documentação da API REST e conteúdo baseado em linguagem de programação.

Recursos de tradução de texto

A Tradução de Texto suporta os seguintes métodos:

Línguas. Retorna uma lista de idiomas suportados pelas operações Traduzir, Transliterar e Pesquisa de Dicionário . Esta solicitação não requer autenticação; basta copiar e colar a seguinte solicitação GET em sua ferramenta ou navegador favorito da API REST:
```
https://api.cognitive.microsofttranslator.com/languages?api-version=3.0
```
Traduzir. Renderiza texto em um único idioma de origem para vários textos no idioma de destino com uma única solicitação.
Transliterar. Converte caracteres ou letras de um idioma de origem para os caracteres ou letras correspondentes de um idioma de destino.
Detetar. Retorna o código de idioma do código-fonte e uma variável booleana indicando se o idioma detetado é suportado para tradução e transliteração de texto.

Observação

Você pode traduzir, transliterar e detetar texto com uma única chamada de API REST.
Pesquisa de dicionário. Oferece palavras equivalentes para o termo de origem na língua-alvo.
Exemplo de dicionário Devolve exemplos de estrutura gramatical e contexto para o par de termos de origem e de destino.

Opções de implantação de tradução de texto

Adicione Tradução de Texto aos seus projetos e aplicativos usando os seguintes recursos:

Aceda ao serviço Translator baseado na nuvem através da API REST, disponível no Azure.
Use a solicitação de API REST com o contêiner de tradução de texto do Docker.
Importante
- Para usar o contentor do Translator, deves preencher e enviar o formulário de solicitação online dos Serviços de IA do Azure para Serviços Fechados para aprovação de acesso ao contentor.
- A imagem do contêiner do Translator suporta recursos limitados em comparação com as ofertas de nuvem.

Residência de dados

A residência de dados da Tradução de Texto depende da região do Azure onde o recurso do Tradutor foi criado:

Residência de dados de tradução de texto

✔️ Característica: Tradutor de texto

Ponto final de serviço	Centro de dados de processamento de pedidos
Global (recomendado): `api.cognitive.microsofttranslator.com`	Data center disponível mais próximo.
Américas: `api-nam.cognitive.microsofttranslator.com`	Leste dos EUA 2 • Oeste dos EUA 2
Ásia-Pacífico `api-apc.cognitive.microsofttranslator.com`:	Leste do Japão • Sudeste Asiático
Europa (exceto Suíça): `api-eur.cognitive.microsofttranslator.com`	França Central • Europa Ocidental
Suíça: Para obter mais informações, consultePontos de extremidade de serviço da Suíça.	Suíça Norte • Suíça Oeste

Pontos finais de serviço na Suíça

Os clientes com um recurso localizado na Suíça Norte ou Suíça Oeste podem garantir que suas solicitações de API de texto sejam atendidas na Suíça. Para garantir que as solicitações sejam tratadas na Suíça, crie o recurso Tradutor no Resource regionSwitzerland North ou Switzerland West, e em seguida, use o ponto de extremidade personalizado do recurso nas suas solicitações de API.

Por exemplo: se criar um recurso Tradutor no portal do Azure com Resource region como Switzerland North e o nome do recurso for my-swiss-n, então o seu ponto de extremidade personalizado será https://my-swiss-n.cognitiveservices.azure.com. E um exemplo de solicitação para traduzir é:

// 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

O Tradutor Personalizado não está disponível atualmente na Suíça.

Introdução à tradução de texto

Pronto para começar?

Crie um recurso de Tradutor no portal do Azure.
Obtenha as suas chaves de acesso e o endpoint de API. Uma URL de ponto de extremidade e uma chave somente leitura são necessárias para autenticação.
Explore nosso Guia de início rápido "Aprenda a usar o Translator via REST e uma linguagem de programação preferida.") e exiba casos de uso e exemplos de código para as seguintes linguagens de programação:

Próximos passos

Aprofunde-se na API REST de tradução de texto:

Consulte a referência da API REST