Partager via


Qu’est-ce que la Traduction de texte Azure ?

La Traduction de texte Azure est une fonctionnalité d’API REST basée sur le cloud du service Translator qui utilise la technologie de traduction automatique neuronale pour permettre une traduction de texte source en temps réel rapide et précise dans toutes les langues prises en charge. Dans cette présentation, vous apprenez comment les API REST Traduction de texte vous permettent de créer des solutions intelligentes pour vos applications et vos workflows.

Cette traduction de documentation contient les types d’articles suivants :

  • Démarrages rapides. Des instructions de prise en main qui vous guident dans la formulation de vos requêtes au service.
  • Guides pratiques. Des instructions sur l’utilisation du service de manière plus spécifique ou personnalisée.
  • Articles de référence. Documentation sur l’API REST et contenu basé sur le langage de programmation.

Fonctionnalités de traduction de texte

La Traduction de texte prend en charge les méthodes suivantes :

  • Langues. Retourne une liste des langues prises en charge par les opérations Traduire, Translittérer et Rechercher dans le dictionnaire. Cette requête ne nécessite pas d’authentification. Il vous suffit de copier et coller la requête GET suivante dans votre navigateur ou outil API REST favori :

    https://api.cognitive.microsofttranslator.com/languages?api-version=3.0
    
  • Traduire. Restitue un texte en langage source unique dans plusieurs textes de langue cible avec une seule requête.

  • Translittérer. Convertit des caractères ou des lettres d’une langue source en caractères ou lettres correspondants d’une langue cible.

  • Détecter. Retourne la langue source et une variable booléenne indiquant si la langue détectée est prise en charge pour la traduction et la translittération de texte.

    Notes

    Vous pouvez traduire, translittérer et détecter le texte avec un seul appel d’API REST.

  • Recherche dans le dictionnaire. Retourne des mots équivalents pour le terme source dans la langue cible.

  • Exemple de dictionnaire Retourne une structure grammaticale et des exemples de contexte pour la paire terme source et terme cible.

Options de déploiement de la traduction de texte

Ajoutez la traduction de texte à vos projets et applications à l’aide des ressources suivantes :

Résidence des données

La résidence des données de traduction de texte dépend de la région Azure où votre ressource Traducteur a été créée :

Résidence des données de traduction de texte

✔️ Fonctionnalité : Traduction de texte Translator Text

Point de terminaison de service Centre de données de traitement des requêtes
Global (recommandé) :
api.cognitive.microsofttranslator.com
Centre de données disponible le plus proche.
Amériques :
api-nam.cognitive.microsofttranslator.com
USA Est 2, USA Ouest 2
Asie-Pacifique :
api-apc.cognitive.microsofttranslator.com
Japon Est • Asie Sud-Est
Europe (à l’exception de la Suisse) :
api-eur.cognitive.microsofttranslator.com
France Centre • Europe Ouest
Suisse :
Pour découvrir plus d’informations, consultez Points de terminaison de service Suisse.
Suisse Nord, Suisse Ouest

Points de terminaison de service Suisse

Les clients disposant d’une ressource située dans la région Suisse Nord ou Suisse Ouest peuvent s’assurer que leurs requêtes d’API de texte sont traitées en Suisse. Pour veiller à ce que les requêtes soient gérées en Suisse, créez la ressource Traducteur dans la Resource region Switzerland North ou Switzerland West, puis utilisez le point de terminaison personnalisé de la ressource dans vos requêtes d’API.

Par exemple : si vous créez une ressource Translator dans le Portail Azure avec Resource region comme Switzerland North et que le nom de votre ressource est my-swiss-n, votre point de terminaison personnalisé est https​://my-swiss-n.cognitiveservices.azure.com. Et voici un exemple de demande de traduction :

// Pass secret key and region using headers to a custom endpoint
curl -X POST "https://my-swiss-n.cognitiveservices.azure.com/translator/text/v3.0/translate?to=fr" \
-H "Ocp-Apim-Subscription-Key: xxx" \
-H "Ocp-Apim-Subscription-Region: switzerlandnorth" \
-H "Content-Type: application/json" \
-d "[{'Text':'Hello'}]" -v

Traducteur personnalisé n’est actuellement pas disponible en Suisse.

Bien démarrer avec la traduction de texte

Vous êtes prêt à commencer ?

Étapes suivantes

Explorez plus en détail l’API REST de traduction de texte :