DescribeVoices - Amazon Polly
请求语法URI 请求参数请求正文响应语法响应元素错误另请参阅
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

DescribeVoices

返回在请求语音合成时可用的语音列表。每个声音都说一种特定的语言，要么是男声，要么是女声，并且由 ID 标识，这是语音名称的 ASCII 版本。

合成语音 (SynthesizeSpeech) 时，您需要从返回的语音列表中为想要的语音提供语音 IDDescribeVoices。

例如，您希望新闻阅读器应用程序以特定语言阅读新闻，但允许用户选择语音。使用该DescribeVoices操作，您可以为用户提供可供选择的可用语音列表。

您可以选择指定语言代码以筛选可用语音。例如，如果您指定en-US，则该操作将返回所有可用的美国英语语音的列表。

此操作需要执行 polly:DescribeVoices 操作的权限。

请求语法

GET /v1/voices?Engine=Engine&IncludeAdditionalLanguageCodes=IncludeAdditionalLanguageCodes&LanguageCode=LanguageCode&NextToken=NextToken HTTP/1.1

URI 请求参数

请求使用以下 URI 参数。

Engine

指定 Amazon Polly 在处理用于语音合成的输入文本时使用的引擎（standard或neural）。

有效值: standard | neural

IncludeAdditionalLanguageCodes

布尔值，表示是否返回任何使用指定语言作为附加语言的双语语音。例如，如果您请求所有使用美国英语 (es-US) 的语言，并且有一个同时说意大利语 (it-it) 和美式英语的意大利语配音，则如果您指定，则该语音将包括在内，yes但如果您指定，则不包括该语音no。

LanguageCode

用于筛选返回的语音列表的语言识别标签（语言名称的 ISO 639 代码-ISO 3166 国家/地区代码）。如果您不指定该可选参数，则得到所有可用的声音。

有效值: arb | cmn-CN | cy-GB | da-DK | de-DE | en-AU | en-GB | en-GB-WLS | en-IN | en-US | es-ES | es-MX | es-US | fr-CA | fr-FR | is-IS | it-IT | ja-JP | hi-IN | ko-KR | nb-NO | nl-NL | pl-PL | pt-BR | pt-PT | ro-RO | ru-RU | sv-SE | tr-TR | en-NZ | en-ZA

NextToken

先前DescribeVoices操作返回的不透明分页标记。如果存在，则表示在哪里继续列出。

长度限制：最小长度为 0。最大长度为 4096。

请求正文

该请求没有请求体。

响应语法

HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "Voices": [ 
      { 
         "AdditionalLanguageCodes": [ "string" ],
         "Gender": "string",
         "Id": "string",
         "LanguageCode": "string",
         "LanguageName": "string",
         "Name": "string",
         "SupportedEngines": [ "string" ]
      }
   ]
}

响应元素

如果此操作成功，则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回的以下数据。

NextToken

在下一个继续列出语音的请求中使用的分页令牌。 NextToken仅在响应截断时返回。

类型：字符串

长度约束：最小长度为 0。最大长度为 4096。

Voices

声音及其属性的列表。

类型：Voice 对象数组

错误

InvalidNextTokenException

NextToken 无效。请确认拼写正确，然后重试。

HTTP 状态代码：400

ServiceFailureException

未知情况导致服务故障。

HTTP 状态代码：500

另请参阅

有关在特定语言的 Amazon 软件开发工具包中使用此 API 的更多信息，请参阅以下内容：