Compartir a través de

Azure Translator en Foundry Tools 3.0: Detección

Identifica el idioma de un fragmento de texto.

URL de la solicitud

Envíe una POST solicitud a:

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

ConsulteCompatibilidad con red virtual para la configuración y el soporte técnico de la red seleccionada de Translator y el punto de conexión privado.

Parámetros de solicitud

Los parámetros de solicitud pasados en la cadena de consulta son:

Parámetro de consulta Description
versión de la API Parámetro obligatorio.
Versión de la API solicitada por el cliente. El valor debe ser 3.0.

Los encabezados de solicitud incluyen:

Headers Description
Encabezados de autenticación Encabezado de solicitud requerido.
Consulte las opciones disponibles para la autenticación.
Tipo de contenido Encabezado de solicitud requerido.
Especifica el tipo de contenido de la carga útil. Los valores posibles son: application/json.
Content-Length Opcional.
Longitud del cuerpo de la solicitud.
X-ClientTraceId Opcional.
Guid generado por el cliente para identificar de forma única la solicitud. Puede omitir este encabezado si incluye el identificador de seguimiento en la cadena de consulta mediante un parámetro de consulta denominado ClientTraceId.

Cuerpo de la solicitud

El cuerpo de la solicitud es una matriz JSON. Cada elemento de matriz es un objeto JSON con una propiedad de cadena denominada Text. La detección de idioma se aplica al valor de la Text propiedad . La detección automática del idioma funciona mejor con texto de entrada más largo. Un cuerpo de solicitud de ejemplo tiene el siguiente aspecto:

[
    { "text": "Ich würde wirklich gerne Ihr Auto ein paar Mal um den Block fahren." }
]

Se presentan las siguientes limitaciones:

  • La matriz puede tener como máximo 100 elementos.
  • El texto completo incluido en la solicitud no puede superar los 50 000 caracteres, incluidos los espacios.

Cuerpo de respuesta

Una respuesta correcta es una matriz JSON con un resultado para cada cadena de la matriz de entrada. Un objeto de resultado incluye las siguientes propiedades:

  • language: código del idioma detectado.

  • score: valor float que indica la confianza en el resultado. La puntuación está entre cero y una y una puntuación baja indica una confianza baja.

  • isTranslationSupported: valor booleano que es true si el idioma detectado es uno de los idiomas admitidos para la traducción de texto.

  • isTransliterationSupported: valor booleano que es true si el idioma detectado es uno de los idiomas admitidos para la transliteración.

  • alternatives: matriz de otros idiomas posibles. Cada elemento de la matriz es otro objeto las siguientes propiedades: language, score, isTranslationSupportedy isTransliterationSupported.

Una respuesta JSON de ejemplo es:

[

    {

        "language": "de",

        "score": 1.0,

        "isTranslationSupported": true,

        "isTransliterationSupported": false

    }

]

Encabezados de respuesta

Headers Description
X-RequestId Valor generado por el servicio para identificar la solicitud y usarse con fines de solución de problemas.

Códigos de estado de respuesta

A continuación se muestran los códigos de estado HTTP posibles que devuelve una solicitud.

Código de estado Description
200 Éxito.
400 Falta uno de los parámetros de consulta o no es válido. Corrija los parámetros de solicitud antes de volver a intentarlo.
401 No se pudo autenticar la solicitud. Compruebe que las credenciales se especifican y son válidas.
403 La solicitud no está autorizada. Compruebe el mensaje de error de detalles. Este código suele indicar que se usan todas las traducciones gratuitas proporcionadas con una suscripción de prueba.
429 El servidor rechazó la solicitud porque el cliente superó los límites de solicitud.
500 Error inesperado. Si el error persiste, notifique con: fecha y hora del error, identificador de solicitud del encabezado de respuesta y identificador de cliente del encabezado X-RequestIdX-ClientTraceIdde solicitud .
503 El servidor no está disponible temporalmente. Vuelva a intentar la solicitud. Si el error persiste, notifique con: fecha y hora del error, identificador de solicitud del encabezado de respuesta y identificador de cliente del encabezado X-RequestIdX-ClientTraceIdde solicitud .

Si se produce un error, la solicitud devuelve una respuesta de error JSON. El código de error es un número de 6 dígitos que combina el código de estado HTTP de 3 dígitos seguido de un número de 3 dígitos para clasificar aún más el error. Los códigos de error comunes se pueden encontrar en la página de referencia de Translator v3.

Examples

En el ejemplo siguiente se muestra cómo recuperar idiomas admitidos para la traducción de texto.

curl -X POST "https://api.cognitive.microsofttranslator.com/detect?api-version=3.0" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json" -d "[{'Text':'What language is this text written in?'}]"
  • Last updated on