Ressources Azure pour Translator

• Une ressource Foundry est votre principal outil pour créer, déployer et gérer des applications et des agents d’IA génératives. Avec cette ressource, vous pouvez accéder aux services d’agent, utiliser des modèles hébergés dans un environnement sans serveur, exécuter des évaluations et vous connecter au service Azure OpenAI.
  

• Si vous envisagez d’utiliser un modèle LLM pour la traduction, vous devez utiliser une ressource Foundry.
  

• Pour savoir comment créer et gérer une ressource Foundry , consultezCréer votre première ressource Foundry

Une ressource Azure Translator est une instance du service que vous créez. Toutes les demandes d’API adressées à Foundry Tools sont accessibles avec une URL de point de terminaison et une clé en lecture seule pour l’authentification de l’accès.

Prerequisites

Pour commencer, il vous faut un compte Azure actif.

Créer votre ressource Azure Translator

Avec votre compte Azure, vous pouvez accéder à Translator via deux types de ressources différents :

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

• Les types de ressources multiservices permettent d’accéder à plusieurs outils Foundry à l’aide d’une seule clé API et d’un point de terminaison.

Complétez les détails relatifs à votre projet et votre instance

Après avoir choisi le type de ressource que vous souhaitez utiliser pour accéder à Translator, 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 prévoyez d'utiliser la fonctionnalité de traduction de documents avec l'autorisation d'identité gérée, choisissez une région géographique telle que l'Est des États-Unis.

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

   Note

   Si vous utilisez une fonctionnalité de traducteur qui nécessite un point de terminaison de domaine personnalisé, comme la traduction de documents, la saisie dans le champ name correspond au paramètre de nom de domaine personnalisé pour le point de terminaison.

Veillez à entrer la valeur correcte dans le champ name pour garantir une fonctionnalité appropriée.

1. 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 documents 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 documents, sélectionnez le niveau d’instance Standard S1.

2. Si vous avez créé 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.

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

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

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

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

La méthode la plus rapide pour authentifier vos demandes d’API Foundry Tools consiste à inclure votre URL de point de terminaison et une clé en lecture seule dans un en-tête d’authentification. Pour plus d'informations, consultezAuthentification et autorisation

• Clés d’authentification. Votre clé est une chaîne unique transmise à chaque requête 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.

Obtenir vos clés d’authentification et votre point de terminaison

Pour authentifier votre connexion à votre ressource Traducteur, vous avez besoin de la clé et du point de terminaison de votre ressource.

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 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.

Créer un client de traduction de texte

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

• Pour créer un TextTranslationClient à l'aide d'une ressource globale, vous avez besoin de votre clé API de ressource :

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

• Pour créer un TextTranslationClient à l'aide d’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>');
  

Commencez avec les API REST Azure Translator

Dans notre guide de démarrage rapide, découvrez comment utiliser Translator avec les API REST.