Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
¿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.
Vaya al recurso de Translator en el portal de Azure.
Seleccione Redes en la sección Administración de recursos.
En la pestaña Firewalls y redes virtuales, seleccione Redes y puntos de conexión privados seleccionados.
Seleccione Guardar para aplicar los cambios.
Seleccione Claves y punto de conexión en la sección Administración de recursos .
Seleccione la pestaña Virtual Network.
En la lista se muestran los puntos de conexión para la traducción de texto y la traducción de documentos.
| 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.
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. |