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

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

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

指定引擎 (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对象

错误

InvalidNextTokenException

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

HTTP 状态代码:400

ServiceFailureException

未知情况导致了服务失败。

HTTP 状态代码:500

另请参阅

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