arrow_back

API Google Cloud Speech : Qwik Start

API Google Cloud Speech : Qwik Start

30 minutes 1 crédit

GSP119

Google Cloud – Ateliers adaptés au rythme de chacun

Présentation

L'API Google Cloud Speech permet d'intégrer facilement les technologies de reconnaissance vocale de Google aux applications en cours de développement. Grâce à cette API, vous pouvez envoyer des fichiers audio et en recevoir une transcription par le biais du service (pour plus d'informations, reportez-vous à la documentation concernant l'API Google Cloud Speech).

Objectifs de l'atelier

  • Créer une clé API

  • Créer une requête d'API Speech

  • Appeler la requête d'API Speech

Configuration et conditions requises

Avant de cliquer sur le bouton Start Lab (Démarrer l'atelier)

Lisez ces instructions. Les ateliers sont minutés, et vous ne pouvez pas les mettre en pause. Le minuteur, qui démarre lorsque vous cliquez sur Start Lab (Démarrer l'atelier), indique combien de temps les ressources Google Cloud resteront accessibles.

Cet atelier pratique Qwiklabs vous permet de suivre vous-même les activités dans un véritable environnement cloud, et non dans un environnement de simulation ou de démonstration. Des identifiants temporaires vous sont fournis pour vous permettre de vous connecter à Google Cloud le temps de l'atelier.

Conditions requises

Pour réaliser cet atelier, vous devez :

  • avoir accès à un navigateur Internet standard (nous vous recommandons d'utiliser Chrome) ;
  • disposer de suffisamment de temps pour réaliser l'atelier en une fois.

Remarque : Si vous possédez déjà votre propre compte ou projet Google Cloud, veillez à ne pas l'utiliser pour réaliser cet atelier.

Remarque : Si vous utilisez un appareil Chrome OS, exécutez cet atelier dans une fenêtre de navigation privée.

Maintenant que vous avez commencé l'atelier, vous devez vous connecter à la console Google Cloud Shell, puis ouvrir l'outil de ligne de commande.

Démarrer l'atelier et se connecter à la console Google Cloud

  1. Cliquez sur le bouton Démarrer l'atelier. Si l'atelier est payant, un pop-up s'affiche pour vous permettre de sélectionner un mode de paiement. Sur la gauche, vous trouverez le panneau Détails concernant l'atelier, qui contient les éléments suivants :

    • Le bouton Ouvrir la console Google
    • Le temps restant
    • Les identifiants temporaires que vous devez utiliser pour cet atelier
    • Des informations complémentaires vous permettant d'effectuer l'atelier
  2. Cliquez sur Ouvrir la console Google. L'atelier lance les ressources, puis ouvre la page Se connecter dans un nouvel onglet.

    Conseil : Réorganisez les onglets dans des fenêtres distinctes, placées côte à côte.

    Remarque : Si la boîte de dialogue Sélectionner un compte s'affiche, cliquez sur Utiliser un autre compte.
  3. Si nécessaire, copiez le nom d'utilisateur inclus dans le panneau Détails concernant l'atelier et collez-le dans la boîte de dialogue Se connecter. Cliquez sur Suivant.

  4. Copiez le mot de passe inclus dans le panneau Détails concernant l'atelier et collez-le dans la boîte de dialogue de bienvenue. Cliquez sur Suivant.

    Important : Vous devez utiliser les identifiants fournis dans le panneau de gauche. Ne saisissez pas vos identifiants Google Cloud Skills Boost. Remarque : Si vous utilisez votre propre compte Google Cloud pour cet atelier, des frais supplémentaires peuvent vous être facturés.
  5. Accédez aux pages suivantes :

    • Acceptez les conditions d'utilisation.
    • N'ajoutez pas d'options de récupération ni d'authentification à deux facteurs (ce compte est temporaire).
    • Ne vous inscrivez pas aux essais offerts.

Après quelques instants, la console Cloud s'ouvre dans cet onglet.

Remarque : Vous pouvez afficher le menu qui contient la liste des produits et services Google Cloud en cliquant sur le menu de navigation en haut à gauche. Icône du menu de navigation

Google Cloud Shell

Activer Google Cloud Shell

Google Cloud Shell est une machine virtuelle qui contient des outils pour les développeurs. Elle comprend un répertoire d'accueil persistant de 5 Go et s'exécute sur Google Cloud. Google Cloud Shell offre un accès en ligne de commande à vos ressources GCP.

  1. Dans la console GCP, dans la barre d'outils située en haut à droite, cliquez sur le bouton Ouvrir Cloud Shell.

    Icône Cloud Shell

  2. Cliquez sur Continue (Continuez):

    cloudshell_continue

Il faut quelques instants pour mettre en service et se connecter à l'environnement. Lorsque vous êtes connecté, vous êtes déjà authentifié et le projet est défini sur votre PROJECT_ID. Par exemple:

Terminal Cloud Shell

gcloud est l'outil de ligne de commande associé à Google Cloud Platform. Pré-installé sur Cloud Shell, il est également compatible avec la saisie semi-automatique via la touche de tabulation.

Vous pouvez répertorier les noms des comptes actifs à l'aide de cette commande :

gcloud auth list

Résultat :

ACTIVE: *
ACCOUNT: student-01-xxxxxxxxxxxx@qwiklabs.net
To set the active account, run:
    $ gcloud config set account `ACCOUNT`
	

Pour répertorier les ID de projet, exécutez la commande suivante :

gcloud config list project
	

Résultat :

[core]
project = <ID_Projet>
	

Exemple de résultat :

[core]
project = qwiklabs-gcp-44776a13dea667a6
	

Tache 1. Créer une clé API

Comme vous allez exécuter la commande curl pour envoyer une requête à l'API Speech, vous devez générer une clé API pour transmettre l'URL de notre requête.

  1. Pour créer une clé API, cliquez sur le menu de navigation > APIs & Services > Credentials (API et services > Identifiants).
  2. Cliquez ensuite sur Create credentials (Créer des identifiants).
  3. Dans le menu déroulant, sélectionnez API key (Clé API).
  4. Copiez la clé que vous venez de générer et cliquez sur Fermer.

Cliquez sur Check my progress (Vérifier ma progression) pour vérifier l'objectif.

Créer une clé API

Maintenant que vous avez une clé API, enregistrez-la dans une variable d'environnement pour éviter d'avoir à insérer sa valeur dans chaque requête.

Pour effectuer les étapes suivantes, connectez-vous à l'aide de SSH à l'instance provisionnée pour vous.

  1. Dans le menu de navigation, sélectionnez Compute Engine. Vous devriez voir une instance Linux répertoriée dans la fenêtre Instances de VM.
  2. Cliquez sur le bouton SSH en ligne avec l'instance Linux. Vous serez amené à un shell interactif.
  3. Dans la ligne de commande, entrez ce qui suit, en remplaçant par la clé API que vous avez copiée à partir de la génération précédente :
  4. export API_KEY=<VOTRE_CLÉ_API>
    

    Restez dans cette session SSH jusqu'à la fin de l'atelier.

    Tâche 2. Créer votre requête d'API Speech

    Remarque : Vous allez utiliser un fichier préenregistré disponible sur Google Cloud Storage : gs://cloud-samples-tests/speech/brooklyn.flac. Vous pouvez écouter ce fichier à cette adresse avant de l'envoyer à l'API Speech.
    1. Créez request.json dans la ligne de commande SSH. Vous l'utiliserez pour créer votre requête à l'API Speech :
    2. touch request.json
      
    3. Ouvrez le request.json :
    4. nano request.json
      
      Remarque : vous pouvez utiliser votre éditeur de ligne de commande préféré (nano, vim, emacs) ou gcloud . Cet atelier fournira des instructions pour nano.
    5. Ajoutez ce qui suit à votre fichier request.json, en utilisant la valeur uri de l'exemple de fichier audio brut :
    6. {
        "config": {
            "encoding":"FLAC",
            "languageCode": "en-US"
        },
        "audio": {
            "uri":"gs://cloud-samples-tests/speech/brooklyn.flac"
        }
      }
      
    7. Appuyez sur control + x puis y pour enregistrer et fermer le fichier request.json.
    8. Le corps de la requête a deux objets : config et audio.

      Dans config, vous indiquez à l'API Speech comment elle doit traiter la requête, Le paramètre encoding spécifie à l'API le type d'encodage audio qui est utilisé pendant l'envoi du fichier à l'API. FLAC est le type d'encodage associé aux fichiers .raw (consultez cette documentation sur les types d'encodages pour en savoir plus).

      Vous pouvez ajouter d'autres paramètres à votre objet config, mais encoding est le seul obligatoire ici.

      Dans l'objet audio, l'URI du fichier audio dans Cloud Storage est transmis à l'API.

      Cliquez sur Check my progress (Vérifier ma progression) pour vérifier l'objectif.

      Créer votre requête d'API Speech

      Vous êtes maintenant prêt à appeler l'API Speech !

      Tâche 3. Appeler l'API Speech

      1. Transmettez le corps de votre requête, ainsi que la variable d'environnement de la clé d'API, à l'API Speech avec la commande curl suivante (le tout dans une seule ligne de commande) :
      2. curl -s -X POST -H "Content-Type: application/json" --data-binary @request.json \
        "https://speech.googleapis.com/v1/speech:recognize?key=${API_KEY}"
        

        Votre réponse doit en principe ressembler à celle-ci :

        {
          "results": [
            {
              "alternatives": [
                {
                  "transcript": "how old is the Brooklyn Bridge",
                  "confidence": 0.98267895
                }
              ]
            }
          ]
        }
        

        La valeur transcript renvoie la transcription que l'API Speech a créée à partir de votre fichier audio, tandis que la valeur confidence indique le niveau de confiance appliqué par l'API à la transcription de votre fichier audio.

        Vous remarquerez que vous avez appelé la méthode syncrecognize dans la requête ci-dessus. L'API Speech est compatible avec une transcription audio synchrone ou asynchrone. Dans cet exemple, vous lui avez envoyé un fichier audio complet, mais vous pourriez tout aussi bien vous servir de la méthode syncrecognize pour réaliser une transcription audio en streaming pendant que l'utilisateur parle.

        Vous avez créé une demande d'API Speech, puis l'avez appelée API Speech.

      3. Exécutez la commande suivante pour enregistrer la réponse dans un fichier result.json :
      curl -s -X POST -H "Content-Type: application/json" --data-binary @request.json \
      "https://speech.googleapis.com/v1/speech:recognize?key=${API_KEY}" > result.json
      

      Cliquez sur Check my progress (Vérifier ma progression) pour vérifier l'objectif.

      Appeler l'API Speech

      Félicitations !

      Cet atelier d'auto-formation "API Google Cloud Speech : Qwik Start" est maintenant terminé. Vous avez intégré une technologie de reconnaissance vocale à une application, puis en avez généré une transcription par le biais du service.

      c5c398f6ade6aa06.png ML-Language-Processing-badge.png

      Terminer votre quête

      Continuez sur votre lancée avec les quêtes Baseline: Data, ML, AI ou Intro to ML: Language Processing. Une quête est une série d'ateliers associés qui constituent une formation. Si vous terminez une quête, vous obtiendrez un badge attestant de votre réussite. Vous pouvez rendre publics les badges que vous recevez et ajouter leur lien dans votre CV en ligne ou sur vos comptes de réseaux sociaux. Inscrivez-vous à l'une des quêtes ci-dessus pour obtenir immédiatement les crédits associés à cet atelier si vous l'avez suivi. Découvrez les autres quêtes Qwiklabs disponibles.

      Atelier suivant

      Cet atelier fait partie d'une série appelée "Qwik Starts". Les ateliers de cette série sont conçus pour vous présenter brièvement les nombreuses fonctionnalités proposées par Google Cloud. Pour trouver le prochain atelier que vous aimeriez suivre, recherchez "Qwik Starts" dans le catalogue.

      Étapes suivantes et informations supplémentaires

Google Cloud Training & Certification

...helps you make the most of Google Cloud technologies. Our classes include technical skills and best practices to help you get up to speed quickly and continue your learning journey. We offer fundamental to advanced level training, with on-demand, live, and virtual options to suit your busy schedule. Certifications help you validate and prove your skill and expertise in Google Cloud technologies.

Dernière mise à jour du manuel le 26 décembre 2022
Dernier test de l'atelier : 26 décembre 2022

Copyright 2020 Google LLC Tous droits réservés. Google et le logo Google sont des marques de Google LLC. Tous les autres noms d'entreprises et de produits peuvent être des marques des entreprises auxquelles ils sont associés.