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

# DescribeVoices
<a name="API_DescribeVoices"></a>

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

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

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

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

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

## 请求语法
<a name="API_DescribeVoices_RequestSyntax"></a>

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

## URI 请求参数
<a name="API_DescribeVoices_RequestParameters"></a>

请求使用以下 URI 参数。

 ** [Engine](#API_DescribeVoices_RequestSyntax) **   <a name="polly-DescribeVoices-request-uri-Engine"></a>
指定 Amazon Polly 在处理输入文本进行语音合成时使用的引擎（`standard`、`neural`、`long-form` 或 `generative`）。  
有效值：`standard | neural | long-form | generative`

 ** [IncludeAdditionalLanguageCodes](#API_DescribeVoices_RequestSyntax) **   <a name="polly-DescribeVoices-request-uri-IncludeAdditionalLanguageCodes"></a>
布尔值，表示是否返回使用指定语言作为附加语言的双语语音。例如，如果您请求所有使用美国英语 (es-US) 的语言，并且有一个意大利语语音同时说意大利语 (it-IT) 和美国英语，那么如果您指定 `yes`，则将包含该语音，但如果您指定 `no`，则不会包含该语音。

 ** [LanguageCode](#API_DescribeVoices_RequestSyntax) **   <a name="polly-DescribeVoices-request-uri-LanguageCode"></a>
 用于筛选返回的语音列表的语言标识标签（语言名称的 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 | cs-CZ | de-CH | en-SG`

 ** [NextToken](#API_DescribeVoices_RequestSyntax) **   <a name="polly-DescribeVoices-request-uri-NextToken"></a>
从上一次 `DescribeVoices` 操作返回的不透明分页标记。如果存在，则表示在哪里继续列出。  
长度限制：最小长度为 0。最大长度为 4096。

## 请求正文
<a name="API_DescribeVoices_RequestBody"></a>

该请求没有请求正文。

## 响应语法
<a name="API_DescribeVoices_ResponseSyntax"></a>

```
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" ]
      }
   ]
}
```

## 响应元素
<a name="API_DescribeVoices_ResponseElements"></a>

如果此操作成功，则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回以下数据。

 ** [NextToken](#API_DescribeVoices_ResponseSyntax) **   <a name="polly-DescribeVoices-response-NextToken"></a>
在下一个请求中使用的分页标记，用于继续列出语音。仅当响应被截断时才会返回 `NextToken`。  
类型：字符串  
长度限制：最小长度为 0。最大长度为 4096。

 ** [Voices](#API_DescribeVoices_ResponseSyntax) **   <a name="polly-DescribeVoices-response-Voices"></a>
语音及其属性的列表。  
类型：[Voice](API_Voice.md) 对象数组

## 错误
<a name="API_DescribeVoices_Errors"></a>

 ** InvalidNextTokenException **   
 NextToken 无效。确保拼写正确，然后请重试。  
HTTP 状态代码：400

 ** ServiceFailureException **   
未知情况导致服务故障。  
HTTP 状态代码：500

## 另请参阅
<a name="API_DescribeVoices_SeeAlso"></a>

有关以特定语言之一使用此 API 的更多信息 Amazon SDKs，请参阅以下内容：
+  [Amazon 命令行界面 V2](https://docs.amazonaws.cn/goto/cli2/polly-2016-06-10/DescribeVoices) 
+  [Amazon 适用于.NET 的 SDK V4](https://docs.amazonaws.cn/goto/DotNetSDKV4/polly-2016-06-10/DescribeVoices) 
+  [Amazon 适用于 C\$1\$1 的 SDK](https://docs.amazonaws.cn/goto/SdkForCpp/polly-2016-06-10/DescribeVoices) 
+  [Amazon 适用于 Go v2 的 SDK](https://docs.amazonaws.cn/goto/SdkForGoV2/polly-2016-06-10/DescribeVoices) 
+  [Amazon 适用于 Java 的 SDK V2](https://docs.amazonaws.cn/goto/SdkForJavaV2/polly-2016-06-10/DescribeVoices) 
+  [Amazon JavaScript V3 版软件开发工具包](https://docs.amazonaws.cn/goto/SdkForJavaScriptV3/polly-2016-06-10/DescribeVoices) 
+  [Amazon 适用于 Kotlin 的 SDK](https://docs.amazonaws.cn/goto/SdkForKotlin/polly-2016-06-10/DescribeVoices) 
+  [Amazon 适用于 PHP 的 SDK V3](https://docs.amazonaws.cn/goto/SdkForPHPV3/polly-2016-06-10/DescribeVoices) 
+  [Amazon Python 软件开发工具包](https://docs.amazonaws.cn/goto/boto3/polly-2016-06-10/DescribeVoices) 
+  [Amazon 适用于 Ruby V3 的 SDK](https://docs.amazonaws.cn/goto/SdkForRubyV3/polly-2016-06-10/DescribeVoices)