Azure Translator dans Foundry Tools 3.0 : BreakSentence

Identifie le positionnement des limites de phrase dans un morceau de texte.

URL de requête

Envoyez une POST demande à :

https://api.cognitive.microsofttranslator.com/breaksentence?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
api-version	Paramètre de requête obligatoire. Version de l’API demandée par le client. La valeur doit être 3.0.
language	Paramètre de requête facultatif. Balise de langue identifiant la langue du texte d’entrée. Si aucun code n’est spécifié, la détection automatique de la langue est appliquée.
scénario	Paramètre de requête facultatif. Balise de script identifiant le script utilisé par le texte d’entrée. Si aucun script n’est spécifié, le script par défaut de la langue est supposé.

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. Les limites de phrase sont calculées pour la valeur de la Text propriété. Un exemple de corps de requête avec une partie de texte ressemble à ceci :

[
    { "text": "How are you? I am fine. What did you do today?" }
]

Les limites suivantes s'appliquent :

• Le tableau peut avoir au maximum 100 éléments.
• La valeur de texte d’un élément de tableau ne peut pas dépasser 50 000 caractères, y compris les espaces.
• Le texte entier inclus dans la requête ne peut pas dépasser 50 000 caractères, y compris les espaces.
• Si le language paramètre de requête est spécifié, tous les éléments de tableau doivent se trouver dans le même langage. Sinon, l’autodétection du langage est appliquée à chaque élément de tableau indépendamment.

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 :

• sentLen: tableau d’entiers représentant les longueurs des phrases dans l’élément de texte. La longueur du tableau est le nombre de phrases, et les valeurs sont la longueur de chaque phrase.

• detectedLanguage: objet décrivant la langue détectée via 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 (0) et un (1,0). Un score faible (<= 0,4) indique une faible confiance.

La detectedLanguage propriété est présente uniquement dans l’objet de résultat lorsque l’autodétection du langage est demandée.

Voici un exemple de réponse JSON :

[
    {
        "detectedLanguage": {
            "language": "en",
            "score": 1.0
        },
        "sentLen": [
            13,
            11,
            22
        ]
    }
]

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 de réponse indique souvent que toutes les traductions gratuites fournies avec un abonnement d’évaluation 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 v3 Translator

Examples

L’exemple suivant montre comment obtenir des limites de phrase pour une seule phrase. Le service détecte automatiquement la langue de phrase.

curl -X POST "https://api.cognitive.microsofttranslator.com/breaksentence?api-version=3.0" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json" -d "[{'Text':'How are you? I am fine. What did you do today?'}]"