Compartilhar via


Início rápido: APIs REST do Tradutor de IA do Azure

Experimente a última versão do Tradutor de IA do Azure. Neste início rápido, comece a usar o serviço de Tradução para traduzir texto usando uma linguagem de programação de sua escolha ou a API REST. Para este projeto, recomendamos usar o tipo de preço gratuito (F0), enquanto você está aprendendo a tecnologia e depois atualizar para um nível pago visando a produção.

Pré-requisitos

Você precisa de uma assinatura ativa do Azure. Se você não tem uma assinatura do Azure, pode criar uma gratuita.

  • 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.

      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 vários serviços ou de Tradução regional da IA do Azure, 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 obter mais informações sobre como usar o cabeçalho Ocp-Apim-Subscription-Region, consulte Cabeçalhos da API REST de Tradução de Texto.

Cabeçalhos

Para chamar o serviço de Tradução por meio da API REST, você precisa incluir os seguintes cabeçalhos em cada solicitação. Não se preocupe, incluímos 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 vários serviços ou regional (geográfico) da IA do Azure como Oeste dos EUA.
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 sobre segurança dos serviços de IA do Azure.

Traduzir o texto

A principal operação do serviço de Tradução é traduzir textos. Neste início rápido, você cria uma solicitação usando uma linguagem de programação de sua escolha que utiliza uma única fonte (from) e fornece duas saídas (to). Em seguida, vamos examinar alguns parâmetros que podem ser usados para ajustar a solicitação e a resposta.

Para obter informações detalhadas sobre os limites da solicitação do serviço Tradutor de IA do Azure, consulte Limites da solicitação de tradução de texto.

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. Para adicionar o pacote ao seu projeto, selecione Instalar na janela direita do gerenciador de pacotes.

    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 mais informações, consulte Novos modelos C# geram declarações de nível superior.
  1. Abra o arquivo Program.cs.

  2. Exclua o código existente, 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 aplicativo, selecione o botão verde Iniciar ao lado de formRecognizer_quickstart para compilar e executar o 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ê acabou de aprender a usar o serviço de Tradução para traduzir texto.

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