Criar um recurso Tradutor

Para começar, você precisa de uma conta do Azure ativa. Se você ainda não tem, crie uma assinatura gratuita de 12 meses.

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

1. Os tipos de recurso de serviço individual habilitam o acesso a uma chave de API e um ponto de extremidade de serviço individual.

2. Os tipos de recurso de Vários serviços habilitam o acesso a vários serviços de IA do Azure usando uma chave de API e ponto de extremidade únicos.

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

1. Assinatura. Selecione uma das suas assinaturas do Azure disponíveis.

2. Grupo de Recursos. Você pode criar um grupo de recursos ou adicionar o recurso a um grupo de recursos existente que compartilhe o mesmo ciclo de vida e as mesmas permissões e políticas.

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

4. Nome. Insira um nome para o recurso. O nome escolhido deve ser exclusivo dentro do Azure.

   Observação

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

5. Tipo de preço. Selecione um tipo de preço que atenda às suas necessidades:

   • Cada assinatura tem uma camada gratuita.
   • A camada gratuita tem os mesmos recursos e funcionalidades que os planos pagos e não expira.
   • Apenas um recurso de camada gratuita está disponível por assinatura.
   • A tradução de documentos tem suporte em camada de serviço pagas. O Language Studio só é suportado nas camadas de instância S1 ou D3. Se você quiser apenas experimentar a Tradução de Documento, selecione a camada de instância Standard S1.

6. Se você criar um recurso de vários serviços, 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 Examinar + criar.

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

9. Depois que o recurso tiver sido implantado com sucesso, selecione Ir para o recurso.

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

   Todas as solicitações da API dos 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 por meio de um parâmetro de cadeia de caracteres de consulta ou especificando-a no cabeçalho de solicitação HTTP.

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

Para autenticar sua conexão com o recurso tradutor, você precisará encontrar suas chaves e ponto de extremidade.

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

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

3. Copie e cole as chaves e a URL do ponto de extremidade em um local conveniente, como o Bloco de notas.

   

A Tradução de Texto dá suporte a pontos de extremidade globais e regionais. Depois de ter suas chaves de autenticação, você precisará 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 da chave de API do 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 de API do recurso e do nome da região em que o recurso está localizado:

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

Para excluir o recurso:

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

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

3. Selecione excluir no menu superior, próximo da borda direita.

4. Insira excluir na caixa de diálogo Excluir Recursos.

5. Selecione Excluir.

Para excluir 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 menus superior.

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