Criar um recurso de tradutor

Para começar, você precisa de uma conta ativa do Azure. Se não tiver uma, pode criar uma subscrição gratuita de 12 meses.

Com sua conta do Azure, você pode acessar o serviço Tradutor por meio de dois tipos de recursos diferentes:

1. Os tipos de recursos de serviço único permitem o acesso a uma única chave de API de serviço e ponto de extremidade.

2. Os tipos de recursos multisserviço permitem o acesso a vários serviços de IA do Azure usando uma única chave de API e ponto de extremidade.

Depois de decidir qual tipo de recurso deseja usar para acessar o serviço Tradutor, você pode inserir os detalhes do seu projeto e instância.

1. Subscrição. Selecione uma das suas subscrições do Azure disponíveis.

2. Grupo de Recursos. Você pode criar um novo grupo de recursos ou adicionar seu recurso a um grupo de recursos pré-existente que compartilha o mesmo ciclo de vida, permissões e políticas.

3. Região de Recursos. Escolha Global , a menos que sua empresa ou aplicativo exija uma região específica. Se você estiver planejando usar o recurso Tradução de Documentos com autorização de identidade gerenciada, escolha uma região geográfica, como Leste dos EUA.

4. Nome. Introduza um nome para o seu recurso. O nome escolhido deve ser exclusivo no Azure.

   Nota

   Se você estiver usando um recurso Tradutor que exija um ponto de extremidade de domínio personalizado, como Tradução de Documento, o valor inserido no campo Nome será o parâmetro de nome de domínio personalizado para o ponto de extremidade.

5. Escalão de preço. Selecione um nível de preço que atenda às suas necessidades:

   • Cada assinatura tem um nível gratuito.
   • O nível gratuito tem os mesmos recursos e funcionalidades dos planos pagos e não expira.
   • Apenas um recurso de nível gratuito está disponível por assinatura.
   • A Tradução de Documentos é suportada apenas no nível pago. O Language Studio suporta as camadas de instância S1 e D3. Se você quiser apenas tentar a Tradução de Documentos, selecione a camada de instância Standard S1.

6. Se você criar um recurso multisserviço, os links na parte inferior da guia Noções básicas fornecerão documentação técnica sobre a operação apropriada do serviço.

7. Selecione Rever + Criar.

8. Revise os termos de serviço e selecione Criar para implantar seu recurso.

9. Depois que o recurso for implantado com êxito, selecione Ir para o recurso.

   Chaves de autenticação e URL do ponto de extremidade

   Todas as solicitações de API de serviços de IA do Azure exigem uma URL de ponto de extremidade e uma chave somente leitura para autenticação.

   • Chaves de autenticação. Sua chave é uma cadeia de caracteres exclusiva que é passada em cada solicitação para o serviço de tradução. Você pode passar sua chave através de um parâmetro query-string ou especificando-o no cabeçalho da solicitação HTTP.

   • URL do ponto de extremidade. Use o ponto de extremidade Global em sua solicitação de API, a menos que você precise de uma região específica do Azure ou ponto de extremidade personalizado. Para obter mais informações, consulte URLs base. O URL do ponto de extremidade global é api.cognitive.microsofttranslator.com.

Para autenticar sua conexão com o recurso do Translator, você precisa encontrar suas chaves e endpoint.

1. Depois que o novo recurso for implantado, selecione Ir para o recurso ou vá para a página do recurso.

2. No painel de navegação esquerdo, em Gerenciamento de Recursos, selecione Chaves e Ponto de Extremidade.

3. Copie e cole suas chaves e URL do ponto de extremidade em um local conveniente, como o Bloco de Notas.

   

A Tradução de Texto suporta endpoints globais e regionais. Depois de ter suas chaves de autenticação, você precisa criar uma instância do TextTranslationClient, usando um AzureKeyCredential para autenticação, para interagir com o serviço de tradução de texto:

1. Para criar um TextTranslationClient usando um ponto de extremidade de recurso global, você precisa de sua chave de API de recurso:

     AzureKeyCredential credential = new('<apiKey>');
     TextTranslationClient client = new(credential);
   

2. Para criar um TextTranslationClient usando um ponto de extremidade de recurso regional, você precisa da chave da API do recurso e do nome da região onde o recurso está localizado:

   AzureKeyCredential credential = new('<apiKey>');
   TextTranslationClient client = new(credential, '<region>');
   

Use a API de tradução de documentos para traduzir de forma assíncrona grandes volumes de texto e vários documentos entre idiomas. O processo de tradução em conjunto requer uma conta de armazenamento de Blobs do Azure com contentores de armazenamento para os seus documentos de origem e traduzidos.

1. Atualmente, a Tradução de Documentos é suportada no recurso Tradutor (serviço único) usando o Plano de Serviço Padrão S1 (Pay-as-you-go) ou no Plano de Desconto por Volume D3.

2. "Para obter mais informações sobre como criar um recurso de tradutor para tradução de documentos, consulte Pré-requisitos: usar tradução de documentos".

Para excluir o recurso:

1. Pesquise e selecione Grupos de recursos no portal do Azure e selecione seu grupo de recursos.

2. Marque os recursos a serem excluídos marcando a caixa de seleção adjacente.

3. Selecione Excluir no menu superior próximo à borda direita.

4. Digite delete na caixa de diálogo Excluir recursos .

5. Selecione Eliminar.

Para eliminar o grupo de recursos:

1. Vá para o seu Grupo de Recursos no portal do Azure.

2. Selecione Excluir grupo de recursos na barra de menu superior.

3. Confirme a solicitação de exclusão inserindo o nome do grupo de recursos e selecionando Excluir.