Guia de Início Rápido: Tradução dos Serviços Cognitivos do Azure

Neste guia de início rápido, você começará a usar o serviço de Tradução para traduzir um texto com uma linguagem de programação de sua escolha e a API REST.

Observação

  • Para este guia de início rápido, é recomendável usar um recurso global de serviço único da Tradução de Texto.
  • Com o recurso global de serviço único, você incluirá um cabeçalho de autorização (Ocp-Apim-Subscription-key) com a solicitação da API REST. O valor de Ocp-Apim-Subscription-key é a chave secreta do Azure para sua assinatura da Tradução de Texto.
  • Se você optar por usar o recurso de Serviços Cognitivos de vários serviços ou de Tradução regional, dois cabeçalhos de autenticação serão exigidos: Ocp-Api-Subscription-Key e Ocp-Apim-Subscription-Region. O valor de Ocp-Apim-Subscription-Region é a região associada à sua assinatura.
  • Para saber mais sobre como usar o cabeçalho Ocp-Apim-Subscription-Region, confira Cabeçalhos da Tradução de Texto da API REST.

Pré-requisitos

Para começar, você precisará ter uma assinatura ativa do Azure. Caso não tenha uma assinatura do Azure, crie uma gratuitamente

  • Depois de obter sua assinatura do Azure, crie um recurso de Tradução no portal do Azure.

  • Após a implantação do recurso, selecione Ir para o recurso para recuperar a chave e o ponto de extremidade.

    • Você precisará da chave e do ponto de extremidade do recurso para conectar seu aplicativo ao serviço de Tradução. Você vai colar a chave e o ponto de extremidade no código mais adiante no guia de início rápido. Você pode encontrar esses valores na página Chaves e ponto de extremidade do portal do Azure:

      Captura de tela: página Chaves e ponto de extremidade do portal do Azure.

  • Use o tipo de preço gratuito (F0) para experimentar o serviço e atualize-o mais tarde para uma camada paga para produção.

Cabeçalhos

Para chamar o serviço de Tradução por meio da API REST, você precisará incluir os cabeçalhos a seguir com cada solicitação. Não se preocupe, pois incluiremos os cabeçalhos para você no código de exemplo de cada linguagem de programação.

Para obter mais informações sobre as opções de autenticação da Tradução, confira o guia de referência da Tradução v3.

Cabeçalho Valor Condição
Ocp-Apim-Subscription-Key Sua chave de serviço de Tradução do portal do Azure. Obrigatório
Ocp-Apim-Subscription-Region A região em que o recurso foi criado. Obrigatório ao usar um recurso de Serviços Cognitivos de vários serviços ou regional (não global).
Opcional ao usar um recurso de Tradução global de serviço único.
Content-Type O tipo de conteúdo da carga. Os valores aceitos são application/json ou charset=UTF-8. Obrigatório
Content-Length O tamanho do corpo da solicitação. Opcional

Importante

Lembre-se de remover a chave do seu código quando terminar e nunca poste-a publicamente. Para produção, use uma maneira segura de armazenar e acessar suas credenciais, como o Azure Key Vault. Para obter mais informações, confira o artigo Segurança dos Serviços Cognitivos.

Traduzir o texto

A principal operação do serviço de Tradução é traduzir textos. Neste guia de início rápido, você criará uma solicitação usando uma linguagem de programação de sua escolha que usa uma só origem (from) e fornece duas saídas (to). Em seguida, examinaremos alguns parâmetros que podem ser usados para ajustar a solicitação e a resposta.

Configurar seu projeto do Visual Studio

  1. Verifique se você tem a versão atual do IDE do Visual Studio.

    Dica

    Caso não esteja familiarizado com o Visual Studio, experimente o módulo Introdução ao Visual Studio do Learn.

  2. Abra o Visual Studio.

  3. Na página Iniciar, escolha Criar um projeto.

    Captura de tela: janela inicial do Visual Studio.

  4. Na página Criar um projeto, insira console na caixa de pesquisa. Escolha o modelo Aplicativo de Console e selecione Avançar.

    Captura de tela: página Criar novo projeto do Visual Studio.

  5. Na janela do diálogo Configurar seu novo projeto, insira translator_quickstart na caixa Nome do projeto. Mantenha a caixa de seleção "Colocar solução e projeto no mesmo diretório" desmarcada e selecione Avançar.

    Captura de tela: janela de diálogo Configurar novo projeto do Visual Studio.

  6. Na janela da caixa de diálogo Informações adicionais, verifique se .NET 6.0 (suporte a longo prazo) está selecionado. Mantenha a caixa de seleção "Não usar instruções de nível superior" desmarcada e selecione Criar.

    Captura de tela: janela de diálogo Informações adicionais do Visual Studio.

Instalar o pacote Newtonsoft.json com o NuGet

  1. Clique com o botão direito do mouse no projeto translator_quickstart e selecione Gerenciar Pacotes NuGet….

    Captura de tela da caixa de pesquisa de pacotes NuGet.

  2. Selecione a guia Procurar e digite Newtonsoft.json.

    Captura de tela da janela de instalação de pacotes NuGet.

  3. Selecione Instalar na janela certa do gerenciador de pacotes para adicionar o pacote ao projeto.

    Captura de tela do botão de instalação de pacotes NuGet.

Compilar seu aplicativo C#

Observação

  • A partir do .NET 6, os novos projetos que usam o modelo console geram um novo estilo de programa diferente das versões anteriores.
  • A nova saída usa recursos recentes do C# que simplificam a codificação.
  • Ao usar a versão mais recente, você só precisa escrever o corpo do método Main. Você não precisa incluir instruções de nível superior, diretivas de uso globais nem diretivas de uso implícitas.
  • Para obter mais informações, consulteNovos modelos C# geram instruções de nível superior.
  1. Abra o arquivo Program.cs.

  2. Exclua o código preexistente, incluindo a linha Console.Writeline("Hello World!"). Copie e cole o exemplo de código no arquivo Program.cs do aplicativo. Atualize a variável de chave com o valor da instância de Tradução do portal do Azure:

using System.Text;
using Newtonsoft.Json;

class Program
{
    private static readonly string key = "<your-translator-key>";
    private static readonly string endpoint = "https://api.cognitive.microsofttranslator.com";

    // location, also known as region.
    // required if you're using a multi-service or regional (not global) resource. It can be found in the Azure portal on the Keys and Endpoint page.
    private static readonly string location = "<YOUR-RESOURCE-LOCATION>";

    static async Task Main(string[] args)
    {
        // Input and output languages are defined as parameters.
        string route = "/translate?api-version=3.0&from=en&to=fr&to=zu";
        string textToTranslate = "I would really like to drive your car around the block a few times!";
        object[] body = new object[] { new { Text = textToTranslate } };
        var requestBody = JsonConvert.SerializeObject(body);

        using (var client = new HttpClient())
        using (var request = new HttpRequestMessage())
        {
            // Build the request.
            request.Method = HttpMethod.Post;
            request.RequestUri = new Uri(endpoint + route);
            request.Content = new StringContent(requestBody, Encoding.UTF8, "application/json");
            request.Headers.Add("Ocp-Apim-Subscription-Key", key);
            // location required if you're using a multi-service or regional (not global) resource.
            request.Headers.Add("Ocp-Apim-Subscription-Region", location);

            // Send the request and get response.
            HttpResponseMessage response = await client.SendAsync(request).ConfigureAwait(false);
            // Read response as a string.
            string result = await response.Content.ReadAsStringAsync();
            Console.WriteLine(result);
        }
    }
}

Executar seu aplicativo C#

Depois de adicionar um exemplo de código ao seu aplicativo, escolha o botão Iniciar verde ao lado de formRecognizer_quickstart para compilar e executar seu programa ou pressione F5.

Captura de tela do botão Executar programa no Visual Studio.

Saída de tradução:

Após uma chamada bem-sucedida, você deverá ver a seguinte resposta:

[
    {
        "detectedLanguage": {
            "language": "en",
            "score": 1.0
        },
        "translations": [
            {
                "text": "J'aimerais vraiment conduire votre voiture autour du pâté de maisons plusieurs fois!",
                "to": "fr"
            },
            {
                "text": "Ngingathanda ngempela ukushayela imoto yakho endaweni evimbelayo izikhathi ezimbalwa!",
                "to": "zu"
            }
        ]
    }
]

Próximas etapas

É isso, parabéns! Você aprendeu a usar o serviço de Tradução para traduzir um texto.

Explore nossa documentação de guias de instruções e aprofunde-se nas funcionalidades do serviço de Tradução: