Étape 2.1 : Configuration du AWS CLI

Suivez ces étapes pour télécharger et configurer le AWS CLI afin qu'il fonctionne avec Amazon Polly.

Important

Vous n'en avez pas besoin AWS CLI pour effectuer les étapes de cet exercice. Cependant, quelques-uns des exercices de ce guide l'utilisent l' AWS CLI. Vous pouvez ignorer cette étape et passer àÉtape 2.2 : Commencer à faire de l'exercice à l'aide du AWS CLI, puis la configurer AWS CLI ultérieurement lorsque vous en aurez besoin.

Configurez le AWS CLI

Pour configurer le AWS Command Line Interface

1. Téléchargez et configurez l’interface AWS CLI. Pour obtenir des instructions, consultez les rubriques suivantes dans le Guide de l'utilisateur de l'AWS Command Line Interface :

   • Mise en place avec le AWS Command Line Interface

   • Configuration du AWS Command Line Interface

2. Ajoutez un profil nommé pour l'utilisateur administrateur dans le fichier AWS CLI AWS Config. Vous pouvez utiliser ce profil lors de l'exécution des AWS CLI commandes. Pour plus d'informations sur les profils nommés, consultez la rubrique Profils nommés dans le Guide de l'utilisateur AWS Command Line Interface .

   [profile adminuser]
       aws_access_key_id = adminuser access key ID
       aws_secret_access_key = adminuser secret access key
       region = aws-region

   Pour obtenir la liste des AWS régions disponibles et de celles prises en charge par Amazon Polly, consultez la section Régions et points de terminaison dans le. Référence générale d'Amazon Web Services

   Note

   Si vous utilisez une région prise en charge par Amazon Polly que vous avez spécifiée lors de la configuration AWS CLI, omettez la ligne suivante dans les exemples de code. AWS CLI

   --region aws-region

3. Vérifiez la configuration en saisissant la commande d'aide suivante à l'invite de commande.

   aws help

   La liste des AWS commandes valides doit apparaître dans la AWS CLI fenêtre.

Activez Amazon Polly depuis AWS CLI

Si vous avez déjà téléchargé et configuré le AWS CLI, Amazon Polly peut ne pas être disponible à moins que vous ne le reconfiguriez. AWS CLI La procédure suivante vérifie si cela est nécessaire.

Pour activer Amazon Polly depuis AWS CLI

1. Vérifiez la disponibilité d'Amazon Polly en saisissant la commande d'aide suivante à l'invite de AWS CLI commande.

   aws polly help

   Si vous voyez une description d'Amazon Polly et qu'une liste de commandes valides apparaît dans la AWS CLI fenêtre, vous pouvez utiliser Amazon Polly immédiatement. AWS CLI Dans ce cas, vous pouvez ignorer le reste de cette procédure. Si ces informations ne sont pas affichées, passez à l'étape 2.

2. Activez Amazon Polly à l'aide de l'une des deux options suivantes :

   1. Désinstallez et réinstallez le AWS CLI.

      Pour obtenir des instructions, reportez-vous à la section Installation du AWS Command Line Interface dans le guide de AWS Command Line Interface l'utilisateur.

      or

   2. Téléchargez le fichier service-2.json.

      À l’invite de commande, exécutez la commande suivante.

      aws configure add-model --service-model file://service-2.json --service-name polly

3. Vérifiez à nouveau la disponibilité d'Amazon Polly.

   aws polly help

   La description d'Amazon Polly doit être visible.

Configurez un moteur vocal à partir du AWS CLI

À partir de AWS CLI, le engine paramètre est facultatif, avec quatre valeurs possibles : generativelong-form,neural, etstandard. Par exemple, si vous utilisez le code suivant pour exécuter la start-speech-synthesis-task AWS CLI commande dans la région USA West-2 (Oregon) :

aws polly start-speech-synthesis-task \
  --engine neural
  --region us-west-2 \
  --endpoint-url "https://polly.us-west-1.amazonaws.com/" \
  --output-format mp3 \
  --output-s3-bucket-name your-bucket-name \
  --output-s3-key-prefix optional/prefix/path/file \
  --voice-id Joanna \
  --text file://text_file.txt

Le résultat ressemblera à ce qui suit :

"SynthesisTask": 
{
     "CreationTime": [..],
     "Engine": "neural",
     "OutputFormat": "mp3",
     "OutputUri": "https://s3.us-west-1.amazonaws.com/your-bucket-name/optional/prefix/path/file.<task_id>.mp3",
     "TextType": "text",
     "RequestCharacters": [..],
     "TaskStatus": "scheduled",
     "TaskId": [task_id],
     "VoiceId": "Joanna"
 }