本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
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 格式返回的以下数据。
错误
- InvalidNextTokenException
-
NextToken 无效。请确认拼写正确,然后重试。
HTTP 状态代码:400
- ServiceFailureException
-
未知情况导致服务故障。
HTTP 状态代码:500
另请参阅
有关在特定语言的 Amazon 软件开发工具包中使用此 API 的更多信息,请参阅以下内容: