步骤 2.1：设置 AWS CLI - Amazon Polly
设置 AWS CLI从中激活 Amazon Polly AWS CLI从中设置语音引擎 AWS CLI

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

步骤 2.1：设置 AWS CLI

请按照以下步骤下载并配置 AWS CLI 以与 Amazon Polly 配合使用。

重要

您不需要， AWS CLI 即可执行本练习中的步骤。但是，本指南中的某些练习会用到 AWS CLI。您可以跳过此步骤并转到步骤 2.2：使用开始练习 AWS CLI， AWS CLI 然后在需要时进行设置。

设置 AWS CLI

要设置 AWS Command Line Interface

  1. 下载并配置 AWS CLI。有关说明，请参阅《AWS Command Line Interface 用户指南》中的以下主题：

  2. 在 Config 文件中为管理员用户添加已命名的 AWS CLI AWS 配置文件。您可以在运行 AWS CLI 命令时使用此配置文件。有关命名配置文件的更多信息，请参阅《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

    有关可用 AWS 区域和 Amazon Polly 支持的区域的列表，请参阅中的区域和终端节点。Amazon Web Services 一般参考

    注意

    如果您使用的是您在配置时指定的 Amazon Polly 支持的区域 AWS CLI，请从代码示例中省略以下行。 AWS CLI 

    --region aws-region

  3. 在命令提示符处键入以下帮助命令来验证设置。

    aws help

    AWS CLI 窗口中应显示有效 AWS 命令的列表。

从中激活 Amazon Polly AWS CLI

如果您之前已经下载并配置过，则除非您重新配置 AWS CLI，否则 Amazon Polly 可能不可用。 AWS CLI以下过程将检查是否有必要。

要从中激活 Amazon Polly AWS CLI

  1. 在命令提示符下键入以下帮助命令，以验证 Amazon Polly 的 AWS CLI 可用性。

    aws polly help

    如果您看到 Amazon Polly 的描述并且 AWS CLI 窗口中显示了有效命令列表，则可以立即使用 Amazon Polly。 AWS CLI 在这种情况下，您可以跳过此过程的剩余部分。如果未显示，请继续执行步骤 2。

  2. 使用以下两个选项之一激活 Amazon Polly：

    1. 卸载并重新安装。 AWS CLI

      有关说明，请参阅 AWS Command Line Interface 用户指南中的安装 AWS Command Line Interface。

      或者

    2. 下载文件 service-2.json。

      在命令提示符下，运行以下命令。

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

  3. 重新验证 Amazon Polly 的可用性。

    aws polly help

    Amazon Polly 的描述应可见。

从中设置语音引擎 AWS CLI

从中 AWS CLI，engine参数是可选的，有四个可能的值：generativelong-form、neural、和standard。例如，如果您使用以下代码在美国西部 2（俄勒冈）区域运行该start-speech-synthesis-task AWS CLI 命令：


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

输出将类似于以下内容：

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