Definir traduções personalizadas

• 5 minutos

Embora o modelo de tradução padrão usado pelo Tradutor de IA do Azure seja eficaz para traduções de modo geral, talvez você precise desenvolver uma solução de tradução para as empresas ou setores com vocabulários de termos específicos que requerem uma tradução personalizada.

Para resolver esse problema, você pode criar um modelo personalizado que mapeie seus próprios conjuntos de termos de origem e de destino para a tradução. Para criar um modelo personalizado, use o portal do Tradutor Personalizado para:

1. Crie um espaço de trabalho vinculado ao seu recurso do Tradutor de IA do Azure.
2. Crie um projeto.
3. Carregue arquivos de dados de treinamento e treine um modelo.
4. Teste seu modelo e publique seu modelo.
5. Faça chamadas de tradução para a API.

Seu modelo personalizado recebe uma ID de categoria exclusiva (realçada na captura de tela), que pode ser especificada em chamadas translate para o recurso Tradutor de IA do Azure usando o parâmetro category, o que faz com que a tradução seja executada pelo modelo personalizado em vez do modelo padrão.

Como chamar a API

Para iniciar uma tradução, envie uma solicitação POST para a seguinte URL de solicitação:

https://api.cognitive.microsofttranslator.com/translate?api-version=3.0

Sua solicitação precisa incluir alguns parâmetros:

• api-version: a versão necessária da API.
• to: o idioma de destino para o qual traduzir. Por exemplo: to=fr para francês.
• category: Sua Id de categoria.

Sua solicitação também deve incluir vários cabeçalhos necessários:

• Ocp-Apim-Subscription-Key. Cabeçalho da chave do cliente. Por exemplo: Ocp-Apim-Subscription-Key=<your-client-key>.
• Content-Type. O tipo de conteúdo da carga. O formato obrigatório é: Content-Type: application/json; charset=UTF-8.

O corpo da solicitação deve conter uma matriz que inclui um objeto JSON com uma propriedade Text que especifica o texto que você deseja traduzir:

[
    {"Text":"Where can I find my employee details?"}
]

Há diferentes maneiras de enviar sua solicitação para a API, incluindo o uso de C#, Python e curl. Por exemplo, para fazer uma chamada rápida, você pode enviar uma solicitação POST usando curl:

curl -X POST "https://api.cognitive.microsofttranslator.com/translate?api-version=3.0&from=en&to=nl&category=<category-id>" -H "Ocp-Apim-Subscription-Key: <your-key" -H "Content-Type: application/json; charset=UTF-8" -d "[{'Text':'Where can I find my employee details?'}]"

A solicitação acima faz uma chamada para traduzir uma frase do inglês para o holandês.

Resposta retornada

A resposta retorna um código de resposta 200 se a solicitação foi bem-sucedida. Ela também retorna um corpo de resposta que contém o texto traduzido, desta forma:

[
    {
        "translations":[
            {"text":"Waar vind ik mijn personeelsgegevens?","to":"nl"}
        ]
    }
]

Se a solicitação não tiver sido bem-sucedida, vários códigos de status diferentes poderão ser retornados dependendo do tipo de erro, como 400 (parâmetros de consulta ausentes ou inválidos). Confira Códigos de status de resposta para obter uma lista completa de códigos e sua explicação.