Definir traducciones personalizadas
Aunque el modelo de traducción predeterminado que usa Traductor de Azure AI es eficaz para la traducción general, puede que tenga que desarrollar una solución de traducción para empresas o sectores que tengan vocabularios de términos específicos que requieren traducción personalizada.
Para solucionar este problema, puede crear un modelo personalizado que asigne sus propios conjuntos de términos de origen y destino para la traducción. Para crear un modelo personalizado, use el portal de Traductor personalizado para:
- Cree un área de trabajo vinculada al recurso de Traductor de Azure AI.
- Cree un proyecto.
- Cargue archivos de datos de entrenamiento y entrene un modelo.
- Pruebe el modelo y publique el modelo.
- Realice llamadas de traducción a la API.
Al modelo personalizado se le asigna un id. de categoría único (resaltado en la captura de pantalla), que puede especificar en las llamadas de translate al recurso de Traductor de Azure AI mediante el parámetro category, lo que hace que el modelo personalizado realice la traducción en lugar del modelo predeterminado.
Llamada a la API
Para iniciar una traducción, envíe una solicitud POST a la siguiente dirección URL de solicitud:
https://api.cognitive.microsofttranslator.com/translate?api-version=3.0
La solicitud debe incluir un par de parámetros:
api-version: versión necesaria de la API.to: idioma de destino al que se va a traducir. Por ejemplo:to=frpara francés.category: el id. de categoría.
La solicitud también debe incluir varios encabezados necesarios:
Ocp-Apim-Subscription-Key. Encabezado de la clave de cliente. Por ejemplo:Ocp-Apim-Subscription-Key=<your-client-key>.Content-Type. En este encabezado se especifica el tipo de contenido de la carga. El formato requerido es:Content-Type: application/json; charset=UTF-8.
El cuerpo de la solicitud debe contener una matriz que incluya un objeto JSON con una propiedad Text que especifique el texto que desea traducir:
[
{"Text":"Where can I find my employee details?"}
]
Hay diferentes maneras de enviar la solicitud a la API, incluido el uso de C#, Python y curl. Por ejemplo, para realizar una llamada rápida, puede enviar una solicitud POST mediante 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?'}]"
La solicitud anterior realiza una llamada para traducir una frase de inglés a neerlandés.
Respuesta devuelta
La respuesta devuelve un código de respuesta de 200 si la solicitud se ha realizado correctamente. También devuelve un cuerpo de respuesta que contiene el texto traducido, de la siguiente manera:
[
{
"translations":[
{"text":"Waar vind ik mijn personeelsgegevens?","to":"nl"}
]
}
]
Si la solicitud no se ha realizado correctamente, se pueden devolver varios códigos de estado diferentes en función del tipo de error, como 400 (faltan o no son parámetros de consulta no válidos). Consulte Códigos de estado de respuesta para obtener una lista completa de códigos y su explicación.
Nota:
Para obtener más información sobre la traducción personalizada, consulte Inicio rápido: Compilación, publicación y traducción con modelos personalizados.