Etapa 2.1: Configurar o AWS CLI

Siga estas etapas para baixar e configurar o AWS CLI para funcionar com o Amazon Polly.

Importante

Você não precisa do AWS CLI para executar as etapas deste exercício. No entanto, alguns dos exercícios neste guia usam a AWS CLI. Você pode pular essa etapaEtapa 2.2: Começar a se exercitar usando o AWS CLI, acessar e configurar a AWS CLI mais tarde quando precisar.

Configure o AWS CLI

Para configurar o AWS Command Line Interface

1. Faça download e configure a AWS CLI. Para obter instruções, consulte os seguintes tópicos no Manual do usuário do AWS Command Line Interface :

   • Configurando o AWS Command Line Interface

   • Configurando o AWS Command Line Interface

2. Adicione um perfil nomeado para o usuário administrador no AWS CLI AWS arquivo Config. Você pode usar esse perfil ao executar os AWS CLI comandos. Para obter mais informações sobre perfis nomeados, consulte Perfis nomeados no Guia do usuário da 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

   Para obter uma lista das AWS regiões disponíveis e aquelas suportadas pelo Amazon Polly, consulte Regiões e endpoints no. Referência geral da Amazon Web Services

   nota

   Se você estiver usando uma região suportada pelo Amazon Polly que você especificou ao configurar o AWS CLI, omita a seguinte linha dos exemplos de código. AWS CLI

   --region aws-region

3. Verifique a configuração digitando o comando de ajuda a seguir no prompt de comando.

   aws help

   Uma lista de AWS comandos válidos deve aparecer na AWS CLI janela.

Ative o Amazon Polly a partir do AWS CLI

Se você já baixou e configurou o AWS CLI, o Amazon Polly pode estar indisponível, a menos que você reconfigure o. AWS CLI O procedimento a seguir verifica se isso é necessário.

Para ativar o Amazon Polly a partir do AWS CLI

1. Verifique a disponibilidade do Amazon Polly digitando o seguinte comando de ajuda no prompt de comando. AWS CLI

   aws polly help

   Se você ver uma descrição do Amazon Polly e uma lista de comandos válidos aparecer na AWS CLI janela, você poderá usar o Amazon Polly imediatamente. AWS CLI Nesse caso, você poderá ignorar o restante deste procedimento. Se isso não for exibido, vá para a etapa 2.

2. Ative o Amazon Polly usando uma das duas opções a seguir:

   1. Desinstale e reinstale o. AWS CLI

      Para instruções, consulte Instalar a AWS Command Line Interface no Guia do usuário da AWS Command Line Interface .

      ou

   2. Faça download do arquivo service-2.json.

      No prompt de comando, execute o seguinte comando da .

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

3. Verifique novamente a disponibilidade do Amazon Polly.

   aws polly help

   A descrição do Amazon Polly deve estar visível.

Configure um mecanismo de voz a partir do AWS CLI

A partir do AWS CLI, o engine parâmetro é opcional, com quatro valores possíveis: generative long-formneural,, standard e. Por exemplo, se você usar o código a seguir para executar o start-speech-synthesis-task AWS CLI comando na região Oeste dos EUA 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

A saída será semelhante à seguinte:

"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"
 }