Definir traduções personalizadas

Concluído

Embora o modelo de tradução padrão usado pelo Azure AI Translator seja eficaz para tradução geral, talvez seja necessário desenvolver uma solução de tradução para empresas ou setores que tenham vocabulários específicos de termos que exigem tradução personalizada.

Para resolver esse problema, você pode criar um modelo personalizado que mapeie seus próprios conjuntos de termos de origem e destino para 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 Azure AI Translator.
2. Crie um projeto.
3. Carregue arquivos de dados de treinamento e treine um modelo.
4. Teste o seu modelo e publique-o.
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 você pode especificar na tradução de chamadas para seu recurso do Azure AI Translator usando o parâmetro category, fazendo com que a tradução seja executada pelo seu modelo personalizado em vez do modelo padrão.

Como chamar a API

Para iniciar uma tradução, envie uma solicitação POST para o 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: A língua de chegada para a qual traduzir. Por exemplo: to=fr para o francês.
• category: O ID da sua categoria.

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

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

O corpo da solicitação deve conter uma matriz que inclua um objeto JSON com uma Text propriedade que especifique 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?'}]"

O pedido acima faz um apelo para traduzir uma frase do inglês para o holandês.

Resposta devolvida

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

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

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

Nota

Para obter mais informações sobre tradução personalizada, consulte Guia de início rápido: criar, publicar e traduzir com modelos personalizados.