Créer une ressource pour Translator

Pour commencer, il vous faut un compte Azure actif. Si vous n’en avez pas, vous pouvez créer un abonnement gratuit de 12 mois.

Avec votre compte Azure, vous pouvez accéder au service Traducteur via deux types de ressources différents :

1. Les types de ressource monoservice permettent d’accéder à une seule clé API et un seul point de terminaison de service.

2. Les types de ressources multiservices permettent d’accéder à plusieurs instances d’Azure AI services à l’aide d’une seule clé API et d’un seul point de terminaison.

Après avoir choisi le type de ressource que vous souhaitez utiliser pour accéder au service Traducteur, vous pouvez entrer les détails de votre projet et de votre instance.

1. Abonnement. Sélectionnez l’un de vos abonnements Azure disponibles.

2. Groupe de ressources. Vous pouvez créer un groupe de ressources ou ajouter votre ressource à un groupe de ressources préexistant qui partage le même cycle de vie, les mêmes autorisations et les mêmes stratégies.

3. Région de la ressource. Choisissez Globale, sauf si votre entreprise ou votre application nécessite une région spécifique. Si vous envisagez d’utiliser la fonctionnalité Traduction de documentations avec une autorisation par identité managée, choisissez une région géographique tel que USA Est.

4. Nom. Entrez un nom pour votre ressource. Le nom choisi doit être unique dans Azure.

   Remarque

   Si vous utilisez une fonctionnalité de Traducteur qui nécessite un point de terminaison de domaine personnalisé, comme la traduction de documentation, la valeur que vous entrez dans le champ Nom correspond au paramètre de nom de domaine personnalisé du point de terminaison.

5. Niveau tarifaire. Sélectionnez un niveau tarifaire qui répond à vos besoins :

   • Chaque abonnement a un niveau gratuit.
   • Le niveau gratuit a les mêmes fonctionnalités et fonctions que les plans payants et n’a pas de date d’expiration.
   • Une seule ressource de niveau gratuit est disponible par abonnement.
   • La traduction de documentation est prise en charge dans les niveaux payants. Language Studio prend uniquement en charge les instances de niveaux S1 ou D3. Si vous souhaitez simplement essayer la traduction de documentation, sélectionnez le niveau d’instance Standard S1.

6. Si vous créez une ressource multiservices, les liens situés en bas de l’onglet Informations de base fournissent une documentation technique concernant l’opération appropriée du service.

7. Sélectionnez Vérifier + créer.

8. Passez en revue les conditions du service, puis sélectionnez Créer pour déployer votre ressource.

9. Une fois votre ressource correctement déployée, sélectionnez Accéder à la ressource.

   Clés d’authentification et URL de point de terminaison

   Toutes les requêtes d’API Azure AI Services nécessitent un point de terminaison d’URL ainsi qu’une clé d’authentification en lecture seule.

   • Clés d’authentification. Votre clé est une chaîne unique qui est passée à chaque requête adressée au service de traduction. Vous pouvez passer votre clé via un paramètre de chaîne de requête ou en la spécifiant dans l’en-tête de requête HTTP.

   • URL de point de terminaison. Utilisez le point de terminaison global dans votre requête d’API, sauf si vous avez besoin d’une région Azure spécifique ou d’un point de terminaison personnalisé. Pour plus d’informations, consultez URL de base. L’URL de point de terminaison global est api.cognitive.microsofttranslator.com.

Pour authentifier votre connexion auprès de votre ressource Translator, vous devez trouver ses clés et son point de terminaison.

1. Une fois votre nouvelle ressource déployée, sélectionnez Accéder à la ressource, ou accédez à votre page de ressources.

2. Dans le volet de navigation gauche, sous Gestion des ressources, sélectionnez Clés et point de terminaison.

3. Copiez et collez vos clés et votre URL de point de terminaison dans un emplacement pratique, par exemple le Bloc-notes.

   

La traduction de texte prend en charge les points de terminaison globaux et régionaux. Une fois que vous avez vos clés d’authentification, vous devez créer une instance de TextTranslationClient en utilisant AzureKeyCredential pour l’authentification, de manière à interagir avec le service de traduction de texte :

1. Pour créer un TextTranslationClient en utilisant un point de terminaison de ressource global, vous avez besoin de votre clé API de ressource :

     AzureKeyCredential credential = new('<apiKey>');
     TextTranslationClient client = new(credential);
   

2. Pour créer un TextTranslationClient en utilisant un point de terminaison de ressource régional, vous avez besoin de votre clé API de ressource et du nom de la région où se trouve votre ressource :

   AzureKeyCredential credential = new('<apiKey>');
   TextTranslationClient client = new(credential, '<region>');
   

Pour supprimer la ressource :

1. Recherchez et sélectionnez Groupes de ressources dans le portail Azure, puis sélectionnez votre groupe de ressources.

2. Sélectionnez les ressources à supprimer en cochant la case adjacente.

3. Dans le menu supérieur près du bord droit, sélectionnez Supprimer.

4. Entrez suppression dans la boîte de dialogue Supprimer les ressources.

5. Sélectionnez Supprimer.

Pour supprimer le groupe de ressources :

1. Accédez au groupe de ressources dans le portail Azure.

2. Sélectionnez Supprimer le groupe de ressources dans la barre de menus supérieure.

3. Confirmez la demande de suppression en entrant le nom du groupe de ressources et en sélectionnant Supprimer.