DescribeVoices - Amazon Polly
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 在处理用于语音合成的输入文本时使用的引擎(standardneural)。

有效值: 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 的更多信息,请参阅以下内容: