Avant de commencer

Text-to-Speech est une API optimisée par la technologie d'intelligence artificielle (IA) de Google. Vous envoyez vos données de transcription à Text-to-Speech dans un appel d'API, puis vous recevez en réponse une voix humaine synthétique aux sonorités naturelles en tant que contenu audio lisible. Pour en savoir plus sur le fonctionnement de Text-to-Speech, consultez la page Principes de base.

Nous vous fournissons des exemples de code qui vous montrent comment envoyer une requête à l'API et recevoir une réponse. Vous pouvez apprendre à utiliser ces exemples en suivant les guides de démarrage rapide et les guides d'utilisation de Text-to-Speech.

Ce guide vous explique les étapes nécessaires pour commencer à envoyer des requêtes à l'API Text-to-Speech.

Présentation

Avant de pouvoir utiliser Text-to-Speech, vous devez activer l'API dans la console Google Cloud Platform. Les étapes ci-dessous vous guident à travers les actions suivantes :

  • Activez Text-to-Speech sur un projet.
    1. Vérifiez que la facturation est activée pour Text-to-Speech.
    2. Assurez-vous que votre projet dispose d'au moins un compte de service.
    3. Téléchargez une clé d'identifiants de compte de service.
  • Définissez la variable d'environnement d'authentification.

Configurer votre projet Google Cloud Platform

  1. Se connecter à Cloud Console

  2. Accéder à la page de sélection du projet

    Vous pouvez sélectionner un projet existant ou en créer un. Pour en savoir plus sur la création d'un projet, consultez la documentation Google Cloud Platform.

  3. Si vous créez un nouveau projet, vous serez invité à y associer un compte de facturation. Si vous utilisez un projet préexistant, assurez-vous que la facturation est activée.

    Découvrez comment vérifier que la facturation est activée pour votre projet.

  4. Une fois que vous avez sélectionné un projet et que vous l'avez associé à un compte de facturation, vous pouvez activer l'API Text-to-Speech. Accédez à la barre Rechercher des produits et des ressources en haut de la page et saisissez "speech". Sélectionnez l'API Cloud Text-to-Speech dans la liste des résultats.

  5. Pour essayer Text-to-Speech sans l'associer à votre projet, sélectionnez l'option ESSAYER CETTE API. Pour activer l'API Text-to-Speech afin de l'utiliser avec votre projet, cliquez sur ACTIVER.

  6. Vous devez maintenant associer un ou plusieurs comptes de service à l'API Text-to-Speech. Cliquez sur le lien Credentials (Identifiants) situé à gauche de la page de l'API Text-to-Speech :

    Si vous n'avez pas de compte de service associé à ce projet, créez-en un en suivant les instructions de la section Créer un compte de service.

    Si vous avez déjà créé des comptes de service associés à ce projet, ils apparaîtront sur cette page. Assurez-vous d'avoir accès à une clé JSON téléchargée associée au compte de service que vous souhaitez utiliser pour vous authentifier avec Text-to-Speech. Les clés de compte de service ne peuvent être téléchargées qu'une seule fois, au moment de leur création. Si votre compte de service possède une clé existante, mais que vous ne trouvez pas le fichier .json téléchargé, vous devez créer une autre clé pour ce compte de service et télécharger son fichier .json. Pour savoir comment créer une clé sur un compte de service existant, suivez les instructions de la section Créer une clé JSON.

    Si vous possédez déjà un compte de service et sa clé JSON, vous pouvez désormais définir votre variable d'environnement d'authentification.

Créer un compte de service

  1. Créez un compte de service si votre projet n'en possède pas déjà un. Vous devez créer un compte de service pour utiliser Text-to-Speech.

    Accéder à la page "Créer un compte de service"

    Dans la zone Nom du compte de service, saisissez un nom unique pour le nouveau compte de service. Votre saisie est automatiquement renseignée dans la zone ID du compte de service. La zone Description du compte de service est facultative mais recommandée si vous prévoyez d'associer plusieurs comptes de service à votre projet. Saisissez une brève description du compte de service dans cette zone, puis cliquez sur CRÉER ET CONTINUER.

  2. Nous vous recommandons d'attribuer l'un des rôles IAM de base à votre compte de service. Vous pouvez également attribuer plusieurs rôles à un seul compte de service si nécessaire. Consultez la section Rôles IAM pour en savoir plus sur les rôles disponibles et les autorisations accordées à chacun d'entre eux. Cliquez sur le menu déroulant Sélectionner un rôle et faites défiler la page jusqu'à la section Basic. Sélectionnez un rôle pour ce compte de service parmi les options qui figurent dans la colonne de droite. Cliquez sur CONTINUER.

  3. La dernière étape vous permet d'autoriser éventuellement d'autres entités (individus, groupes Google, etc.) à accéder à votre compte de service. Si vous n'avez pas besoin d'accorder un accès supplémentaire, vous pouvez cliquer sur OK sans saisir d'informations.

  4. Le compte de service est désormais répertorié sur la page Comptes de service. Vous pouvez modifier les autorisations du compte de service, ajouter ou générer des clés et accorder l'accès à tout moment.

Créer une clé JSON pour votre compte de service

  1. Le nouveau compte de service s'affiche sur la page "Comptes de service". Créez une clé privée qui sera associée au compte. Vous devez utiliser cette clé privée lors du processus d'authentification lorsque vous envoyez une requête à Text-to-Speech. Si vous choisissez de ne pas créer de clé maintenant, vous pouvez générer une clé et/ou modifier les informations de chaque utilisateur à tout moment en accédant au compte de service via l'option IAM et administration -> Comptes de service dans le menu de navigation principal.

    Pour créer une clé, cliquez sur le compte de service et sélectionnez CLÉS. Cliquez sur AJOUTER UNE CLÉ -> Créer une clé. Nous vous recommandons de créer une clé au format JSON.

  2. Une nouvelle clé au format de votre choix est automatiquement téléchargée. Stockez ce fichier dans un endroit sûr et notez le chemin d'accès au fichier. Vous devez faire pointer la variable d'environnement GOOGLE_APPLICATION_CREDENTIALS vers ce fichier lorsque vous effectuez le processus d'authentification au début de chaque nouvelle session Text-to-Speech. Il s'agit d'une étape essentielle pour authentifier les requêtes dans Text-to-Speech. L'ID unique de la clé apparaît à côté du nom du compte de service.

Définir la variable d'environnement d'authentification

Pour définir votre GOOGLE_APPLICATION_CREDENTIALS, vous devez disposer d'un compte de service associé à votre projet et avoir accès à la clé JSON du compte de service.

Fournissez des identifiants d'authentification au code de votre application en définissant la variable d'environnement GOOGLE_APPLICATION_CREDENTIALS. Cette variable ne s'applique qu'à la session d'interface système actuelle. Si vous souhaitez que la variable s'applique aux sessions d'interface système futures, définissez-la dans votre fichier de démarrage de l'interface système, par exemple dans le fichier ~/.bashrc ou ~/.profile.

Linux ou macOS

export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

Remplacez KEY_PATH par le chemin du fichier JSON contenant la clé de votre compte de service.

Exemple :

export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"

Windows

Pour PowerShell :

$env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

Remplacez KEY_PATH par le chemin du fichier JSON contenant la clé de votre compte de service.

Exemple :

$env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"

Pour l'invite de commande :

set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

Remplacez KEY_PATH par le chemin du fichier JSON contenant la clé de votre compte de service.

Pour en savoir plus, consultez la documentation sur l'authentification dans Google Cloud Platform.

Désactiver l'API Text-to-Speech

Pour désactiver l'API Text-to-Speech, accédez à votre tableau de bord Google Cloud Platform, puis cliquez sur le lien Accéder à la présentation des API dans la zone API. Cliquez sur l'API Text-to-Speech, puis sélectionnez le bouton DÉSACTIVER L'API en haut de la page.

Étape suivante

Découvrez comment envoyer une requête de transcription à l'API Text-to-Speech à l'aide de bibliothèques clientes ou de la ligne de commande.