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.0Traduire. 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 :
Accédez au service Traducteur cloud via l’API REST, disponible dans Azure.
Utilisez la requête translate de l’API REST avec le conteneur Docker de traduction de texte.
Important
Pour utiliser le conteneur Translator, vous devez remplir et soumettre le formulaire de requête en ligne Azure AI Services pour Gated Services et le faire approuver pour acquérir l'accès au conteneur.
L’image conteneur Translator prend en charge des fonctionnalités limitées par rapport aux offres cloud.
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 ?
Créer une ressource Traducteur dans le portail Azure.
Récupérez vos clés d’accès et votre point de terminaison d’API. Une URL de point de terminaison et une clé en lecture seule sont requises pour l’authentification.
Explorez notre démarrage rapide et consultez des cas d’usage et des exemples de code pour les langages de programmation suivants :
Étapes suivantes
Explorez plus en détail l’API REST de traduction de texte :