DescribeVoices - Amazon Polly
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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

DescribeVoices

返回在请求语音合成时可用的语音列表。每个语音都说一种特定的语言,可以是男性语音也可以是女性语音,并由 ID(即语音名称的 ASCII 版本)标识。

合成语音 (SynthesizeSpeech) 时,您需要从 DescribeVoices 返回的语音列表中提供所需的语音 ID。

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

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

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

请求语法

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

URI 请求参数

请求使用以下 URI 参数。

Engine

指定 Amazon Polly 在处理语音合成输入文本时使用的引擎(standardneurallong-form)。

有效值:standard | neural | long-form

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 | ca-ES | de-AT | yue-CN | ar-AE | fi-FI | en-IE | nl-BE | fr-BE

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 SDK 中使用此 API 的更多信息,请参阅以下内容: