Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

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

Mengembalikan daftar suara yang tersedia untuk digunakan saat meminta sintesis ucapan. Setiap suara berbicara bahasa tertentu, baik laki-laki atau perempuan, dan diidentifikasi oleh ID, yang merupakan versi ASCII dari nama suara. 

Saat mensintesis speech (`SynthesizeSpeech`), Anda memberikan ID suara untuk suara yang Anda inginkan dari daftar suara yang dikembalikan oleh. `DescribeVoices`

Misalnya, Anda ingin aplikasi pembaca berita Anda membaca berita dalam bahasa tertentu, tetapi memberi pengguna opsi untuk memilih suara. Dengan menggunakan `DescribeVoices` operasi ini, Anda dapat memberi pengguna daftar suara yang tersedia untuk dipilih.

 Anda dapat secara opsional menentukan kode bahasa untuk memfilter suara yang tersedia. Misalnya, jika Anda menentukan`en-US`, operasi mengembalikan daftar semua suara bahasa Inggris AS yang tersedia. 

Operasi ini memerlukan izin untuk menjalankan tindakan `polly:DescribeVoices`.

## Minta Sintaks
<a name="API_DescribeVoices_RequestSyntax"></a>

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

## Parameter Permintaan URI
<a name="API_DescribeVoices_RequestParameters"></a>

Permintaan menggunakan parameter URI berikut.

 ** [Engine](#API_DescribeVoices_RequestSyntax) **   <a name="polly-DescribeVoices-request-uri-Engine"></a>
Menentukan mesin (`standard`,`neural`, `long-form` atau`generative`) yang digunakan oleh Amazon Polly saat memproses teks input untuk sintesis ucapan.   
Nilai Valid: `standard | neural | long-form | generative` 

 ** [IncludeAdditionalLanguageCodes](#API_DescribeVoices_RequestSyntax) **   <a name="polly-DescribeVoices-request-uri-IncludeAdditionalLanguageCodes"></a>
Nilai Boolean menunjukkan apakah akan mengembalikan suara bilingual yang menggunakan bahasa tertentu sebagai bahasa tambahan. Misalnya, jika Anda meminta semua bahasa yang menggunakan bahasa Inggris AS (es-US), dan ada suara Italia yang berbicara bahasa Italia (IT-IT) dan Inggris AS, suara itu akan disertakan jika Anda menentukan `yes` tetapi tidak jika Anda menentukan. `no`

 ** [LanguageCode](#API_DescribeVoices_RequestSyntax) **   <a name="polly-DescribeVoices-request-uri-LanguageCode"></a>
 Tag identifikasi bahasa (kode ISO 639 untuk nama bahasa-ISO 3166 kode negara) untuk memfilter daftar suara yang dikembalikan. Jika Anda tidak menentukan parameter opsional ini, semua suara yang tersedia akan dikembalikan.   
Nilai Valid: `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>
Token pagination buram dikembalikan dari operasi sebelumnya`DescribeVoices`. Jika ada, ini menunjukkan di mana harus melanjutkan daftar.  
Batasan Panjang: Panjang minimum sebesar 0. Panjang maksimum 4096.

## Isi Permintaan
<a name="API_DescribeVoices_RequestBody"></a>

Permintaan tidak memiliki isi permintaan.

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

## Elemen Respons
<a name="API_DescribeVoices_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [NextToken](#API_DescribeVoices_ResponseSyntax) **   <a name="polly-DescribeVoices-response-NextToken"></a>
Token pagination yang akan digunakan dalam permintaan berikutnya untuk melanjutkan daftar suara. `NextToken`dikembalikan hanya jika respons terpotong.  
Tipe: String  
Batasan Panjang: Panjang minimum 0. Panjang maksimum 4096.

 ** [Voices](#API_DescribeVoices_ResponseSyntax) **   <a name="polly-DescribeVoices-response-Voices"></a>
Daftar suara dengan propertinya.  
Tipe: Array objek [Voice](API_Voice.md)

## Kesalahan
<a name="API_DescribeVoices_Errors"></a>

 ** InvalidNextTokenException **   
 NextToken Itu tidak valid. Verifikasi bahwa itu dieja dengan benar, dan kemudian coba lagi.  
Kode Status HTTP: 400

 ** ServiceFailureException **   
Kondisi yang tidak diketahui telah menyebabkan kegagalan layanan.  
Kode Status HTTP: 500

## Lihat Juga
<a name="API_DescribeVoices_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK for C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/DescribeVoices)