Comprendre les concepts de détection de la langue, de traduction et de translittération
Explorons les fonctionnalités d’Azure AI Traducteur. Ces capacités incluent :
Détection de langue
Vous pouvez utiliser la fonction Detect de l’API REST pour détecter la langue dans laquelle le texte est écrit.
Par exemple, vous pouvez envoyer le texte suivant au point de terminaison https://api.cognitive.microsofttranslator.com/detect?api-version=3.0
à l’aide de curl.
Voici le texte que nous voulons traduire :
{ 'Text' : 'こんにちは' }
Voici un appel utilisant curl au point de terminaison pour détecter la langue de notre texte :
curl -X POST "https://api.cognitive.microsofttranslator.com/detect?api-version=3.0" -H "Ocp-Apim-Subscription-Region: <your-service-region>" -H "Ocp-Apim-Subscription-Key: <your-key>" -H "Content-Type: application/json" -d "[{ 'Text' : 'こんにちは' }]
La réponse à cette requête est semblable à ce qui suit, qui indique que le texte est écrit en japonais :
[
{
"language": "ja",
"score": 1.0,
"isTranslationSupported": true,
"isTransliterationSupported": true
}
]
Traduction
Pour traduire un texte d’une langue vers une autre, utilisez la fonction Translate en spécifiant un seul paramètre from pour indiquer la langue source, et un ou plusieurs paramètres to pour spécifier les langues dans lesquelles vous souhaitez que le texte soit traduit.
Par exemple, vous pouvez soumettre le même code JSON que précédemment pour détecter la langue, en spécifiant un paramètre from avec la valeur ja (japonais) et deux paramètres to avec les valeurs en (anglais) et fr (français). Pour ce faire, vous appelez :
curl -X POST "https://api.cognitive.microsofttranslator.com/translate?api-version=3.0&from=ja&to=fr&to=en" -H "Ocp-Apim-Subscription-Key: <your-key>" -H "Ocp-Apim-Subscription-Region: <your-service-region>" -H "Content-Type: application/json; charset=UTF-8" -d "[{ 'Text' : 'こんにちは' }]"
Le résultat obtenu est le suivant :
[
{"translations":
[
{"text": "Hello", "to": "en"},
{"text": "Bonjour", "to": "fr"}
]
}
]
Translittération
Notre texte japonais est écrit en hiragana. Par conséquent, plutôt que de le traduire dans une autre langue, vous souhaiterez peut-être le translittérer vers une autre écriture, comme l'écriture latine utilisée en anglais et en français.
Pour cela, nous pouvons envoyer le texte japonais à la fonction Transliterate, en spécifiant un paramètre fromScript avec la valeur Jpan et un paramètre toScript avec la valeur Latn :
curl -X POST "https://api.cognitive.microsofttranslator.com/transliterate?api-version=3.0&fromScript=Jpan&toScript=Latn" -H "Ocp-Apim-Subscription-Key: <your-key>" -H "Ocp-Apim-Subscription-Region: <your-service-region>" -H "Content-Type: application/json" -d "[{ 'Text' : 'こんにちは' }]"
La réponse devrait vous donner le résultat suivant :
[
{
"script": "Latn",
"text": "Kon'nichiwa"
}
]