Partager via

Azure Translator dans Foundry Tools 3.0 : détecter

Identifie la langue d’un morceau de texte.

URL de requête

Envoyez une POST demande à :

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

ConsultezLa prise en charge du réseau virtuel pour Translator sélectionné réseau et la configuration et la prise en charge des points de terminaison privés.

Paramètres de la demande

Les paramètres de requête transmis sur la chaîne de requête sont les suivants :

Paramètre de requête. Descriptif
version de l'API Paramètre obligatoire.
Version de l’API demandée par le client. La valeur doit être 3.0.

Les en-têtes de demande sont les suivants :

headers Descriptif
En-têtes d’authentification En-tête de demande obligatoire.
Consultez les options disponibles pour l’authentification.
Type de contenu En-tête de demande obligatoire.
Spécifie le type de contenu de la charge utile. Les valeurs possibles sont les suivantes : application/json.
Longueur-contenu Facultatif.
Longueur du corps de la requête.
X-ClientTraceId Facultatif.
GUID généré par le client pour identifier de manière unique la requête. Vous pouvez omettre cet en-tête si vous incluez l’ID de trace dans la chaîne de requête à l’aide d’un paramètre de requête nommé ClientTraceId.

Corps de la requête

Le corps de la requête est un tableau JSON. Chaque élément de tableau est un objet JSON avec une propriété de chaîne nommée Text. La détection de langue est appliquée à la valeur de la Text propriété. La détection automatique de la langue fonctionne mieux avec du texte d’entrée plus long. Un exemple de corps de requête ressemble à ceci :

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

Les limites suivantes s'appliquent :

  • Le tableau peut avoir au maximum 100 éléments.
  • Le texte entier inclus dans la requête ne peut pas dépasser 50 000 caractères, y compris les espaces.

Corps de réponse

Une réponse réussie est un tableau JSON avec un résultat pour chaque chaîne du tableau d’entrée. Un objet de résultat inclut les propriétés suivantes :

  • language: code de la langue détectée.

  • score: valeur float indiquant la confiance dans le résultat. Le score est compris entre zéro et un et un score faible indique une faible confiance.

  • isTranslationSupported: valeur booléenne true si la langue détectée est l’une des langues prises en charge pour la traduction de texte.

  • isTransliterationSupported: valeur booléenne true si la langue détectée est l’une des langues prises en charge pour la translittération.

  • alternatives: tableau d’autres langues possibles. Chaque élément du tableau est un autre objet les propriétés suivantes : language, , score, isTranslationSupportedet isTransliterationSupported.

Voici un exemple de réponse JSON :

[

    {

        "language": "de",

        "score": 1.0,

        "isTranslationSupported": true,

        "isTransliterationSupported": false

    }

]

En-têtes de réponse

headers Descriptif
X-RequestId Valeur générée par le service pour identifier la demande et utilisée à des fins de résolution des problèmes.

Codes d’état de réponse

Voici les codes d’état HTTP possibles qu’une requête retourne.

Code de statut Descriptif
200 Succès.
400 L’un des paramètres de requête est manquant ou non valide. Corrigez les paramètres de requête avant de réessayer.
401 La demande n’a pas pu être authentifiée. Vérifiez que les informations d’identification sont spécifiées et valides.
4:03 La demande n’est pas autorisée. Vérifiez le message d’erreur détaillé. Ce code indique souvent que toutes les traductions gratuites fournies avec un abonnement d’essai sont utilisées.
429 Le serveur a rejeté la demande, car le client a dépassé les limites de requête.
500 Une erreur inattendue s’est produite. Si l’erreur persiste, signalez-la avec : date et heure de l’échec, identificateur de demande à partir de l’en-tête X-RequestIdde réponse et identificateur client de l’en-tête X-ClientTraceIdde requête .
503 Serveur temporairement indisponible. Réessayez la requête. Si l’erreur persiste, signalez-la avec : date et heure de l’échec, identificateur de demande à partir de l’en-tête X-RequestIdde réponse et identificateur client de l’en-tête X-ClientTraceIdde requête .

Si une erreur se produit, la requête retourne une réponse d’erreur JSON. Le code d’erreur est un nombre à 6 chiffres combinant le code d’état HTTP à 3 chiffres suivi d’un nombre à 3 chiffres pour catégoriser davantage l’erreur. Vous trouverez les codes d’erreur courants sur la page de référence de La version 3 de Translator.

Examples

L’exemple suivant montre comment récupérer les langues prises en charge pour la traduction de texte.

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