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

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

DescribeVoices

返回在请求语音合成时可用的语音列表。每个语音使用指定的语言,可以是男性或女性,并且由 ID 标识,该 ID 是语音名称的 ASCII 版本。

当合成语音时(SynthesizeSpeech),您可以从DescribeVoices.

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

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

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

请求语法

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

URI 请求参数

请求使用以下 URI 参数。

Engine

指定引擎 (standard或者neural) 在处理语音合成 Amazon Polly 输入文本时使用。

有效值: 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

一个不透明的分页令牌从上一个DescribeVoicesoperation. 如果存在,则表明继续发布商品的位置。

长度约束:最小长度为 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 objects

Errors

InvalidNextTokenException

下 NextToken 无效。验证拼写是否正确,然后重试。

HTTP 状态代码:400

ServiceFailureException

未知情况导致服务故障。

HTTP 状态代码:500

另请参阅

有关在特定语言的其中一种特定语言的使用此 API 的更多信息Amazon开发工具包: