本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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

傳回請求語音合成時可用的語音清單。每個語音都會說指定的語言，可以是男性或女性，並以 ID 識別，這是語音名稱的 ASCII 版本。

合成語音 (`SynthesizeSpeech`) 時，您可以從 傳回的語音清單中，提供所需語音的語音 ID`DescribeVoices`。

例如，您希望新聞閱讀器應用程式讀取特定語言的新聞，但提供使用者選擇語音的選項。使用 `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 3166 國家/地區代碼的 ISO 639 代碼），用於篩選傳回的語音清單。如果您未指定此選用參數，則會傳回所有可用的語音。  
有效值:`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>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/DescribeVoices) 
+  [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/DescribeVoices) 
+  [AWS 適用於 C\+\+ 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/DescribeVoices) 
+  [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/DescribeVoices) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/DescribeVoices) 
+  [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/DescribeVoices) 
+  [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/DescribeVoices) 
+  [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/DescribeVoices) 
+  [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/DescribeVoices) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/DescribeVoices)