Azure Translator en Foundry Tools v3.0

¿Qué hay nuevo?

La versión 3.0 de Translator proporciona una API web moderna basada en JSON. Mejora la facilidad de uso y el rendimiento consolidando las características existentes en menos operaciones y proporciona nuevas características.

  • Transliteración para convertir texto en un idioma de un script a otro.
  • Traducción a varios idiomas en una solicitud.
  • Detección de idioma, traducción y transliteración en una solicitud.
  • Diccionario para buscar traducciones alternativas de un término, para buscar traducciones inversas y ejemplos que muestran los términos usados en el contexto.
  • Resultados de detección de idioma más informativos.

Direcciones URL base

La dirección URL base global es https://api.cognitive.microsofttranslator.com. La traducción de texto también admite puntos de conexión geográficos y específicos de recursos. Para todas las direcciones URL del punto de conexión y sus ubicaciones de procesamiento de solicitudes, consulte Compatibilidad con regiones para Azure Translator.

compatibilidad con Virtual Network

Translator ya está disponible con funcionalidades de Virtual Network (VNET) en todas las regiones de la nube pública de Azure. Para habilitar Virtual Network, SeeConfigurar redes virtuales de Foundry Tools.

Una vez activada esta funcionalidad, debe usar el punto de conexión personalizado para llamar a Translator. No puede usar el punto de conexión de traductor global ("api.cognitive.microsofttranslator.com") y no se puede autenticar con un token de acceso.

Puede encontrar el punto de conexión personalizado después de crear un recurso de traductor y permitir el acceso desde redes seleccionadas y puntos de conexión privados.

  1. Vaya al recurso de Translator en el portal de Azure.

  2. Seleccione Redes en la sección Administración de recursos.

  3. En la pestaña Firewalls y redes virtuales, seleccione Redes y puntos de conexión privados seleccionados.

    Screenshot de la configuración de red virtual en Azure portal.

  4. Seleccione Guardar para aplicar los cambios.

  5. Seleccione Claves y punto de conexión en la sección Administración de recursos .

  6. Seleccione la pestaña Virtual Network.

  7. En la lista se muestran los puntos de conexión para la traducción de texto y la traducción de documentos.

    Captura de pantalla del punto de conexión de red virtual.

Headers Description
Ocp-Apim-Subscription-Key El valor es la clave secreta Azure de la suscripción a Translator.
Ocp-Apim-Subscription-Region El valor es la región del recurso translator. Este valor es opcional si el recurso es global

Esta es una solicitud de ejemplo para llamar a Translator mediante el punto de conexión personalizado.

// Pass secret key and region using headers
curl -X POST "https://<your-custom-domain>.cognitiveservices.azure.com/translator/text/v3.0/translate?api-version=3.0&to=es" \
     -H "Ocp-Apim-Subscription-Key:<your-key>" \
     -H "Ocp-Apim-Subscription-Region:<your-region>" \
     -H "Content-Type: application/json" \
     -d "[{'Text':'Hello, what is your name?'}]"

Metrics

Las métricas permiten ver la información de disponibilidad y uso del traductor en Azure portal. Para obtener más información, consulte Métricas de datos y plataformas.

Métricas de Translator

En esta tabla se enumeran las métricas disponibles con una descripción de cómo se usan para supervisar las llamadas api de traducción.

Metrics Description
TotalCalls Número total de llamadas API.
TotalTokenCalls Número total de llamadas API a través del servicio de token mediante el token de autenticación.
Llamadas correctas Número de llamadas exitosas.
TotalErrors Número de llamadas con respuesta de error.
BlockedCalls Número de llamadas que han superado la tasa o el límite de cuota.
ServerErrors Número de llamadas con error interno del servidor(5XX).
ClientErrors Número de llamadas con error del lado cliente(4XX).
Latencia Duración para completar la solicitud en milisegundos.
CharactersTranslated Número total de caracteres de la solicitud entrante de texto.