Démarrage rapide : Créer un compte Cognitive Services dans le portail Azure

Ce guide de démarrage rapide vous montre comment commencer à utiliser Azure Cognitive Services. Après avoir créé une ressource Cognitive Services dans le portail Azure, vous obtenez un point de terminaison et une clé pour authentifier vos applications.

La solution Azure Cognitive Services correspond à des services cloud avec des API REST et des kits SDK de bibliothèque de client destinés à aider les développeurs à intégrer une intelligence cognitive dans des applications sans connaissances ni compétences directes en intelligence artificielle (IA) ou en science des données. Azure Cognitive Services permet aux développeurs d’ajouter facilement des fonctionnalités cognitives dans leurs applications à l’aide de solutions cognitives capables de voir, entendre, parler, comprendre et même commencer à raisonner.

Vous pouvez accéder à Azure Cognitive Services via deux ressources différentes : Une ressource multiservice ou une ressource monoservice.

  • Ressource multiservice :
    • Accédez à plusieurs services cognitifs Azure avec une seule clé et un seul point de terminaison.
    • Regroupe la facturation des services que vous utilisez.
  • Ressource monoservice :
    • Accédez à un seul service cognitif Azure avec une clé et un point de terminaison uniques pour chaque service créé.
    • Utilisez le niveau gratuit pour tester le service.

Prérequis

  • Un abonnement Azure valide - Créer un abonnement gratuitement
  • Un rôle Contributeur Cognitive Services doit être affecté à votre compte Azure pour que vous puissiez accepter les conditions d’utilisation de l’IA et créer une ressource. Pour que ce rôle soit attribué à votre compte, suivez les étapes de la documentation Attribuer des rôles ou contactez votre administrateur.

Créer une ressource Azure Cognitive Services

La ressource multiservice est nommée Cognitive Services dans le portail. La ressource multiservice permet d’accéder aux services Cognitive Services suivants :

  • Décision - Content Moderator
  • Langue – Langue, Traducteur
  • Speech – Speech
  • Vision - Vision par ordinateur, vision personnalisée, visage
  1. Vous pouvez sélectionner ce lien pour créer une ressource multi-service Azure Cognitive Services : Créer une ressource Cognitive Services.

  2. Sur la page Créer, renseignez les informations suivantes :

    Détails du projet Description
    Abonnement Sélectionnez l’un de vos abonnements Azure disponibles.
    Groupe de ressources Groupe de ressources Azure comprenant votre ressource Cognitive Services. Vous pouvez créer un groupe ou l’ajouter à un groupe préexistant.
    Région Emplacement de votre instance Cognitive Services. Des emplacements différents peuvent entraîner une latence. Toutefois, cela n’aura pas d’impact sur la disponibilité d’exécution de votre ressource.
    Nom Nom descriptif de votre ressource Cognitive Services. Par exemple, MyCognitiveServicesResource.
    Niveau tarifaire Le coût associé à votre compte Cognitive Services dépend des options que vous choisissez, ainsi que de votre utilisation. Pour plus d'informations, consultez le détail des tarifs de l’API.

    Multi-service resource creation screen

  3. Configurez des paramètres supplémentaires pour votre ressource en fonction des besoins, lisez et acceptez les conditions (le cas échéant), puis sélectionnez Vérifier + créer.

Conseil

Si votre abonnement ne vous permet pas de créer une ressource Cognitive Services, vous devrez peut-être activer cette fonctionnalité du fournisseur de ressources Azure avec le portail Azure, une commande PowerShell ou une commande Azure CLI. Si vous n’êtes pas le propriétaire de l’abonnement, demandez au propriétaire de l’abonnement ou à une personne disposant d’un rôle d’administrateur de terminer l’inscription à votre place ou demandez à ce que les privilèges /register/action soient accordés à votre compte.

Obtenir les clés pour votre ressource

  1. Une fois votre ressource correctement déployée, sélectionnez Étapes suivantes>Accéder à la ressource.

    Get resource keys screen

  2. Dans le volet de démarrage rapide qui s’ouvre, vous pouvez accéder au point de terminaison des ressources et gérer les clés.

  3. Si vous avez manqué les étapes précédentes ou si vous avez besoin de trouver votre ressource ultérieurement, accédez à la page d’accueil des services Azure. À partir de là, vous pouvez afficher les ressources récentes, sélectionner Mes ressources ou utiliser la zone de recherche pour rechercher votre ressource par nom.

    Find resource keys from home screen

Configurer une variable d’environnement pour l’authentification

Les applications ont besoin d’authentifier l’accès à Cognitive Services qu’elles utilisent. Pour l’authentification, nous vous recommandons de créer une variable d’environnement destinée à stocker les clés pour vos ressources Azure.

Après avoir obtenu votre clé, écrivez-la dans une variable d’environnement sur la machine locale exécutant l’application. Pour définir la variable d’environnement, ouvrez une fenêtre de console et suivez les instructions pour votre système d’exploitation. Remplacez your-key par l’une des clés de votre ressource.

setx COGNITIVE_SERVICE_KEY "your-key"

Après avoir ajouté la variable d’environnement, vous devrez peut-être redémarrer tous les programmes en cours d’exécution qui devront la lire, y compris la fenêtre de console. Par exemple, si vous utilisez Visual Studio comme éditeur, redémarrez Visual Studio avant d’exécuter l’exemple.

Nettoyer les ressources

Si vous souhaitez nettoyer et supprimer un abonnement Cognitive Services, vous pouvez supprimer la ressource ou le groupe de ressources. La suppression du groupe de ressources supprime également toutes les autres ressources se trouvant dans le groupe.

  1. Sur le portail Azure, développez le menu de gauche pour ouvrir le menu des services, et sélectionnez Groupes de ressources pour afficher la liste de vos groupes de ressources.
  2. Localisez le groupe de ressources contenant la ressource à supprimer.
  3. Cliquez avec le bouton droit sur la liste des groupes de ressources. Sélectionnez Supprimer le groupe de ressources et confirmez.

Si vous devez récupérer une ressource supprimée, consultez Récupérer des ressources Cognitive Services supprimées.

Voir aussi