Paso 2.1: Configura el AWS CLI

Siga estos pasos para descargar y configurar el AWS CLI para trabajar con Amazon Polly.

importante

No necesitas el AWS CLI para realizar los pasos de este ejercicio. Sin embargo, algunos de los ejercicios de esta guía utilizan la AWS CLI. Puede omitir este paso e ir a yPaso 2.2: Empezar a hacer ejercicio con el AWS CLI, a continuación, configurar el AWS CLI más adelante, cuando lo necesite.

Configure el AWS CLI

Para configurar el AWS Command Line Interface

1. Descargue y configure el AWS CLI. Para obtener instrucciones, consulte los siguientes temas en la AWS Command Line Interface Guía del usuario:

   • Cómo configurarse con el AWS Command Line Interface

   • Configurando el AWS Command Line Interface

2. Agregue un perfil con nombre para el usuario administrador en el AWS CLI AWS Config file. Puede utilizar este perfil al ejecutar el AWS CLI comandos. Para obtener más información sobre los perfiles con nombre, consulte Perfiles con nombre en el AWS Command Line Interface Guía del usuario.

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

   Para obtener una lista de las disponibles AWS Regiones y regiones compatibles con Amazon Polly, consulte Regiones y puntos de enlace en la Referencia general de Amazon Web Services.

   nota

   Si utiliza una región compatible con Amazon Polly que especificó al configurar el AWS CLI, omita la siguiente línea de AWS CLI ejemplos de código.

   --region aws-region

3. Compruebe la configuración; para ello, escriba el siguiente comando de ayuda en el símbolo del sistema.

   aws help

   Una lista de válidos AWS los comandos deberían aparecer en AWS CLI ventana.

Activa Amazon Polly desde AWS CLI

Si descargó y configuró previamente el AWS CLI, es posible que Amazon Polly no esté disponible a menos que vuelva a configurar el AWS CLI. El siguiente procedimiento comprueba si es necesario.

Para activar Amazon Polly desde AWS CLI

1. Comprueba la disponibilidad de Amazon Polly escribiendo el siguiente comando de ayuda en la AWS CLI línea de comandos.

   aws polly help

   Si ve una descripción de Amazon Polly y aparece una lista de comandos válidos en la AWS CLI ventana, puedes usar Amazon Polly desde la AWS CLI inmediatamente. En este caso, puede omitir el resto del procedimiento. Si no aparece, continúe en el paso 2.

2. Active Amazon Polly mediante una de las dos opciones siguientes:

   1. Desinstale y vuelva a instalar el AWS CLI.

      Para obtener instrucciones, consulte Instalación del AWS Command Line Interface en la AWS Command Line Interface Guía del usuario.

      o

   2. Descargue el archivo service-2.json.

      En el símbolo del sistema, ejecute el siguiente comando.

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

3. Vuelva a comprobar la disponibilidad de Amazon Polly.

   aws polly help

   La descripción de Amazon Polly debe estar visible.

Configure un motor de voz desde AWS CLI

Desde el AWS CLI, el engine parámetro es opcional, con cuatro valores posibles: generativelong-form,neural, ystandard. Por ejemplo, si utiliza el código siguiente para ejecutar el start-speech-synthesis-task AWS CLI comando en la región US West-2 (Oregón):

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

El resultado será similar al siguiente:

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