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

# Tindakan
<a name="API_Operations"></a>

Tindakan berikut didukung:
+  [DeleteLexicon](API_DeleteLexicon.md) 
+  [DescribeVoices](API_DescribeVoices.md) 
+  [GetLexicon](API_GetLexicon.md) 
+  [GetSpeechSynthesisTask](API_GetSpeechSynthesisTask.md) 
+  [ListLexicons](API_ListLexicons.md) 
+  [ListSpeechSynthesisTasks](API_ListSpeechSynthesisTasks.md) 
+  [PutLexicon](API_PutLexicon.md) 
+  [StartSpeechSynthesisStream](API_StartSpeechSynthesisStream.md) 
+  [StartSpeechSynthesisTask](API_StartSpeechSynthesisTask.md) 
+  [SynthesizeSpeech](API_SynthesizeSpeech.md) 

# DeleteLexicon
<a name="API_DeleteLexicon"></a>

Menghapus leksikon pengucapan tertentu yang disimpan dalam file. Wilayah AWS Sebuah leksikon yang telah dihapus tidak tersedia untuk sintesis ucapan, juga tidak mungkin untuk mengambilnya menggunakan salah satu atau. `GetLexicon` `ListLexicon` APIs

Untuk informasi selengkapnya, lihat [Mengelola Leksikon](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html).

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

```
DELETE /v1/lexicons/LexiconName HTTP/1.1
```

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

Permintaan menggunakan parameter URI berikut.

 ** [LexiconName](#API_DeleteLexicon_RequestSyntax) **   <a name="polly-DeleteLexicon-request-uri-Name"></a>
Nama leksikon yang akan dihapus. Harus menjadi leksikon yang ada di wilayah tersebut.  
Pola: `[0-9A-Za-z]{1,20}`   
Wajib: Ya

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

Permintaan tidak memiliki isi permintaan.

## Sintaks Respons
<a name="API_DeleteLexicon_ResponseSyntax"></a>

```
HTTP/1.1 200
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong.

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

 ** LexiconNotFoundException **   
Amazon Polly tidak dapat menemukan leksikon yang ditentukan. Ini bisa disebabkan oleh leksikon yang hilang, namanya salah eja atau menentukan leksikon yang ada di wilayah berbeda.  
Verifikasi bahwa leksikon ada, ada di wilayah (lihat[ListLexicons](API_ListLexicons.md)) dan Anda mengeja namanya dieja dengan benar. Kemudian coba lagi.  
Kode Status HTTP: 404

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

## Lihat Juga
<a name="API_DeleteLexicon_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/DeleteLexicon) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/DeleteLexicon) 

# 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\$1\$1](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) 

# GetLexicon
<a name="API_GetLexicon"></a>

Mengembalikan isi dari leksikon pengucapan tertentu yang disimpan dalam file Wilayah AWS. Untuk informasi selengkapnya, lihat [Mengelola Leksikon](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html).

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

```
GET /v1/lexicons/LexiconName HTTP/1.1
```

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

Permintaan menggunakan parameter URI berikut.

 ** [LexiconName](#API_GetLexicon_RequestSyntax) **   <a name="polly-GetLexicon-request-uri-Name"></a>
Nama leksikon.  
Pola: `[0-9A-Za-z]{1,20}`   
Wajib: Ya

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

Permintaan tidak memiliki isi permintaan.

## Sintaks Respons
<a name="API_GetLexicon_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Lexicon": { 
      "Content": "string",
      "Name": "string"
   },
   "LexiconAttributes": { 
      "Alphabet": "string",
      "LanguageCode": "string",
      "LastModified": number,
      "LexemesCount": number,
      "LexiconArn": "string",
      "Size": number
   }
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [Lexicon](#API_GetLexicon_ResponseSyntax) **   <a name="polly-GetLexicon-response-Lexicon"></a>
Objek leksikon yang menyediakan nama dan konten string leksikon.   
Tipe: Objek [Lexicon](API_Lexicon.md)

 ** [LexiconAttributes](#API_GetLexicon_ResponseSyntax) **   <a name="polly-GetLexicon-response-LexiconAttributes"></a>
Metadata leksikon, termasuk alfabet fonetik yang digunakan, kode bahasa, leksikon ARN, jumlah leksem yang ditentukan dalam leksikon, dan ukuran leksikon dalam byte.  
Tipe: Objek [LexiconAttributes](API_LexiconAttributes.md)

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

 ** LexiconNotFoundException **   
Amazon Polly tidak dapat menemukan leksikon yang ditentukan. Ini bisa disebabkan oleh leksikon yang hilang, namanya salah eja atau menentukan leksikon yang ada di wilayah berbeda.  
Verifikasi bahwa leksikon ada, ada di wilayah (lihat[ListLexicons](API_ListLexicons.md)) dan Anda mengeja namanya dieja dengan benar. Kemudian coba lagi.  
Kode Status HTTP: 404

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

## Lihat Juga
<a name="API_GetLexicon_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/GetLexicon) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/GetLexicon) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/GetLexicon) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/GetLexicon) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/GetLexicon) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/GetLexicon) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/GetLexicon) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/GetLexicon) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/GetLexicon) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/GetLexicon) 

# GetSpeechSynthesisTask
<a name="API_GetSpeechSynthesisTask"></a>

Mengambil SpeechSynthesisTask objek tertentu berdasarkan TaskiD-nya. Objek ini berisi informasi tentang tugas sintesis ucapan yang diberikan, termasuk status tugas, dan tautan ke ember S3 yang berisi output tugas.

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

```
GET /v1/synthesisTasks/TaskId HTTP/1.1
```

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

Permintaan menggunakan parameter URI berikut.

 ** [TaskId](#API_GetSpeechSynthesisTask_RequestSyntax) **   <a name="polly-GetSpeechSynthesisTask-request-uri-TaskId"></a>
Amazon Polly menghasilkan pengidentifikasi untuk tugas sintesis ucapan.  
Pola: `^[a-zA-Z0-9_-]{1,100}$`   
Wajib: Ya

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

Permintaan tidak memiliki isi permintaan.

## Sintaks Respons
<a name="API_GetSpeechSynthesisTask_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "SynthesisTask": { 
      "CreationTime": number,
      "Engine": "string",
      "LanguageCode": "string",
      "LexiconNames": [ "string" ],
      "OutputFormat": "string",
      "OutputUri": "string",
      "RequestCharacters": number,
      "SampleRate": "string",
      "SnsTopicArn": "string",
      "SpeechMarkTypes": [ "string" ],
      "TaskId": "string",
      "TaskStatus": "string",
      "TaskStatusReason": "string",
      "TextType": "string",
      "VoiceId": "string"
   }
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [SynthesisTask](#API_GetSpeechSynthesisTask_ResponseSyntax) **   <a name="polly-GetSpeechSynthesisTask-response-SynthesisTask"></a>
SynthesisTask objek yang menyediakan informasi dari tugas yang diminta, termasuk format output, waktu pembuatan, status tugas, dan sebagainya.  
Tipe: Objek [SynthesisTask](API_SynthesisTask.md)

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

 ** InvalidTaskIdException **   
ID Tugas yang diberikan tidak valid. Harap berikan ID Tugas yang valid dan coba lagi.  
Kode Status HTTP: 400

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

 ** SynthesisTaskNotFoundException **   
Tugas Sintesis Pidato dengan ID Tugas yang diminta tidak dapat ditemukan.  
Kode Status HTTP: 400

## Lihat Juga
<a name="API_GetSpeechSynthesisTask_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/GetSpeechSynthesisTask) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/GetSpeechSynthesisTask) 

# ListLexicons
<a name="API_ListLexicons"></a>

Mengembalikan daftar leksikon pengucapan yang disimpan dalam file Wilayah AWS. Untuk informasi selengkapnya, lihat [Mengelola Leksikon](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html).

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

```
GET /v1/lexicons?NextToken=NextToken HTTP/1.1
```

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

Permintaan menggunakan parameter URI berikut.

 ** [NextToken](#API_ListLexicons_RequestSyntax) **   <a name="polly-ListLexicons-request-uri-NextToken"></a>
Token pagination buram dikembalikan dari operasi sebelumnya`ListLexicons`. Jika ada, tunjukkan di mana harus melanjutkan daftar leksikon.  
Batasan Panjang: Panjang minimum sebesar 0. Panjang maksimum 4096.

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

Permintaan tidak memiliki isi permintaan.

## Sintaks Respons
<a name="API_ListLexicons_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Lexicons": [ 
      { 
         "Attributes": { 
            "Alphabet": "string",
            "LanguageCode": "string",
            "LastModified": number,
            "LexemesCount": number,
            "LexiconArn": "string",
            "Size": number
         },
         "Name": "string"
      }
   ],
   "NextToken": "string"
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [Lexicons](#API_ListLexicons_ResponseSyntax) **   <a name="polly-ListLexicons-response-Lexicons"></a>
Daftar nama dan atribut leksikon.  
Tipe: Array objek [LexiconDescription](API_LexiconDescription.md)

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

## Kesalahan
<a name="API_ListLexicons_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_ListLexicons_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/ListLexicons) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/ListLexicons) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/ListLexicons) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/ListLexicons) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/ListLexicons) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/ListLexicons) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/ListLexicons) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/ListLexicons) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/ListLexicons) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/ListLexicons) 

# ListSpeechSynthesisTasks
<a name="API_ListSpeechSynthesisTasks"></a>

Mengembalikan daftar SpeechSynthesisTask objek yang diurutkan berdasarkan tanggal pembuatannya. Operasi ini dapat memfilter tugas berdasarkan statusnya, misalnya, memungkinkan pengguna untuk membuat daftar hanya tugas yang selesai.

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

```
GET /v1/synthesisTasks?MaxResults=MaxResults&NextToken=NextToken&Status=Status HTTP/1.1
```

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

Permintaan menggunakan parameter URI berikut.

 ** [MaxResults](#API_ListSpeechSynthesisTasks_RequestSyntax) **   <a name="polly-ListSpeechSynthesisTasks-request-uri-MaxResults"></a>
Jumlah maksimum tugas sintesis ucapan yang dikembalikan dalam operasi Daftar.  
Rentang yang Valid: Nilai minimum 1. Nilai maksimum 100.

 ** [NextToken](#API_ListSpeechSynthesisTasks_RequestSyntax) **   <a name="polly-ListSpeechSynthesisTasks-request-uri-NextToken"></a>
Token pagination yang akan digunakan dalam permintaan berikutnya untuk melanjutkan daftar tugas sintesis ucapan.   
Batasan Panjang: Panjang minimum sebesar 0. Panjang maksimum 4096.

 ** [Status](#API_ListSpeechSynthesisTasks_RequestSyntax) **   <a name="polly-ListSpeechSynthesisTasks-request-uri-Status"></a>
Status tugas sintesis ucapan dikembalikan dalam operasi Daftar  
Nilai Valid: `scheduled | inProgress | completed | failed` 

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

Permintaan tidak memiliki isi permintaan.

## Sintaks Respons
<a name="API_ListSpeechSynthesisTasks_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "SynthesisTasks": [ 
      { 
         "CreationTime": number,
         "Engine": "string",
         "LanguageCode": "string",
         "LexiconNames": [ "string" ],
         "OutputFormat": "string",
         "OutputUri": "string",
         "RequestCharacters": number,
         "SampleRate": "string",
         "SnsTopicArn": "string",
         "SpeechMarkTypes": [ "string" ],
         "TaskId": "string",
         "TaskStatus": "string",
         "TaskStatusReason": "string",
         "TextType": "string",
         "VoiceId": "string"
      }
   ]
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [NextToken](#API_ListSpeechSynthesisTasks_ResponseSyntax) **   <a name="polly-ListSpeechSynthesisTasks-response-NextToken"></a>
Token pagination buram dikembalikan dari operasi Daftar sebelumnya dalam permintaan ini. Jika ada, ini menunjukkan di mana harus melanjutkan daftar.  
Tipe: String  
Batasan Panjang: Panjang minimum 0. Panjang maksimum 4096.

 ** [SynthesisTasks](#API_ListSpeechSynthesisTasks_ResponseSyntax) **   <a name="polly-ListSpeechSynthesisTasks-response-SynthesisTasks"></a>
Daftar SynthesisTask objek yang menyediakan informasi dari tugas yang ditentukan dalam permintaan daftar, termasuk format output, waktu pembuatan, status tugas, dan sebagainya.  
Tipe: Array objek [SynthesisTask](API_SynthesisTask.md)

## Kesalahan
<a name="API_ListSpeechSynthesisTasks_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_ListSpeechSynthesisTasks_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/ListSpeechSynthesisTasks) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/ListSpeechSynthesisTasks) 

# PutLexicon
<a name="API_PutLexicon"></a>

Menyimpan leksikon pengucapan dalam file Wilayah AWS. Jika leksikon dengan nama yang sama sudah ada di wilayah tersebut, itu ditimpa oleh leksikon baru. Operasi leksikon memiliki konsistensi akhirnya, oleh karena itu, mungkin perlu beberapa waktu sebelum leksikon tersedia untuk operasi. SynthesizeSpeech 

Untuk informasi selengkapnya, lihat [Mengelola Leksikon](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html).

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

```
PUT /v1/lexicons/LexiconName HTTP/1.1
Content-type: application/json

{
   "Content": "string"
}
```

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

Permintaan menggunakan parameter URI berikut.

 ** [LexiconName](#API_PutLexicon_RequestSyntax) **   <a name="polly-PutLexicon-request-uri-Name"></a>
Nama leksikon. Nama harus mengikuti format ekspres reguler [0-9A-za-Z] \$11,20\$1. Artinya, namanya adalah string alfanumerik peka huruf besar/kecil hingga 20 karakter.   
Pola: `[0-9A-Za-z]{1,20}`   
Wajib: Ya

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

Permintaan menerima data berikut dalam format JSON.

 ** [Content](#API_PutLexicon_RequestSyntax) **   <a name="polly-PutLexicon-request-Content"></a>
Isi leksikon PLS sebagai data string.  
Tipe: String  
Diperlukan: Ya

## Sintaksis Respons
<a name="API_PutLexicon_ResponseSyntax"></a>

```
HTTP/1.1 200
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong.

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

 ** InvalidLexiconException **   
Amazon Polly tidak dapat menemukan leksikon yang ditentukan. Verifikasi bahwa nama leksikon dieja dengan benar, lalu coba lagi.  
Kode Status HTTP: 400

 ** LexiconSizeExceededException **   
Ukuran maksimum leksikon yang ditentukan akan dilampaui oleh operasi ini.  
Kode Status HTTP: 400

 ** MaxLexemeLengthExceededException **   
Ukuran maksimum leksem akan dilampaui oleh operasi ini.  
Kode Status HTTP: 400

 ** MaxLexiconsNumberExceededException **   
Jumlah leksikon maksimum akan terlampaui oleh operasi ini.  
Kode Status HTTP: 400

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

 ** UnsupportedPlsAlphabetException **   
Alfabet yang ditentukan oleh leksikon bukanlah alfabet yang didukung. Nilai yang valid adalah `x-sampa` dan `ipa`.  
Kode Status HTTP: 400

 ** UnsupportedPlsLanguageException **   
Bahasa yang ditentukan dalam leksikon tidak didukung. Untuk daftar bahasa yang didukung, lihat [Atribut Leksikon](https://docs.aws.amazon.com/polly/latest/dg/API_LexiconAttributes.html).  
Kode Status HTTP: 400

## Lihat Juga
<a name="API_PutLexicon_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/PutLexicon) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/PutLexicon) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/PutLexicon) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/PutLexicon) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/PutLexicon) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/PutLexicon) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/PutLexicon) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/PutLexicon) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/PutLexicon) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/PutLexicon) 

# StartSpeechSynthesisStream
<a name="API_StartSpeechSynthesisStream"></a>

Mensintesis input UTF-8, teks biasa, atau SSML melalui koneksi streaming dua arah. Tentukan parameter sintesis di header HTTP/2, kirim teks secara bertahap sebagai peristiwa pada aliran input, dan terima audio yang disintesis saat tersedia.

Operasi ini berfungsi sebagai mitra dua arah untuk: `SynthesizeSpeech`
+  [SynthesizeSpeech](https://docs.aws.amazon.com/polly/latest/dg/API_SynthesizeSpeech.html) 

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

```
POST /v1/synthesisStream HTTP/1.1
x-amzn-Engine: Engine
x-amzn-LanguageCode: LanguageCode
x-amzn-LexiconNames: LexiconNames
x-amzn-OutputFormat: OutputFormat
x-amzn-SampleRate: SampleRate
x-amzn-VoiceId: VoiceId
Content-type: application/json

{
   "CloseStreamEvent": { 
   },
   "TextEvent": { 
      "FlushStreamConfiguration": { 
         "Force": boolean
      },
      "Text": "string",
      "TextType": "string"
   }
}
```

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

Permintaan menggunakan parameter URI berikut.

 ** [Engine](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-Engine"></a>
Menentukan mesin untuk Amazon Polly untuk digunakan saat memproses teks input untuk sintesis ucapan. Saat ini, hanya `generative` mesin yang didukung. Jika Anda menentukan suara yang tidak didukung oleh mesin yang dipilih, Amazon Polly menampilkan kesalahan.  
Nilai yang Valid: `standard | neural | long-form | generative`   
Wajib: Ya

 ** [LanguageCode](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-LanguageCode"></a>
Parameter opsional yang menetapkan kode bahasa untuk permintaan sintesis ucapan. Tentukan parameter ini hanya saat menggunakan suara bilingual. Jika suara dwibahasa digunakan dan tidak ada kode bahasa yang ditentukan, Amazon Polly menggunakan bahasa default suara dwibahasa.  
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` 

 ** [LexiconNames](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-LexiconNames"></a>
Nama-nama satu atau lebih leksikon pengucapan untuk layanan yang akan diterapkan selama sintesis. Amazon Polly menerapkan leksikon hanya jika bahasa leksikon cocok dengan bahasa suara.  
Anggota Array: Jumlah maksimum 5 item.  
Pola: `[0-9A-Za-z]{1,20}` 

 ** [OutputFormat](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-OutputFormat"></a>
Format audio untuk pidato yang disintesis. Saat ini, Amazon Polly tidak mendukung tanda bicara JSON.  
Nilai yang Valid: `json | mp3 | ogg_opus | ogg_vorbis | pcm`   
Wajib: Ya

 ** [SampleRate](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-SampleRate"></a>
Frekuensi audio, ditentukan dalam Hz.

 ** [VoiceId](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-VoiceId"></a>
Suara untuk digunakan dalam sintesis. Untuk mendapatkan daftar suara yang tersedia IDs, gunakan [DescribeVoices](https://docs.aws.amazon.com/polly/latest/dg/API_DescribeVoices.html)operasi.  
Nilai yang Valid: `Aditi | Amy | Astrid | Bianca | Brian | Camila | Carla | Carmen | Celine | Chantal | Conchita | Cristiano | Dora | Emma | Enrique | Ewa | Filiz | Gabrielle | Geraint | Giorgio | Gwyneth | Hans | Ines | Ivy | Jacek | Jan | Joanna | Joey | Justin | Karl | Kendra | Kevin | Kimberly | Lea | Liv | Lotte | Lucia | Lupe | Mads | Maja | Marlene | Mathieu | Matthew | Maxim | Mia | Miguel | Mizuki | Naja | Nicole | Olivia | Penelope | Raveena | Ricardo | Ruben | Russell | Salli | Seoyeon | Takumi | Tatyana | Vicki | Vitoria | Zeina | Zhiyu | Aria | Ayanda | Arlet | Hannah | Arthur | Daniel | Liam | Pedro | Kajal | Hiujin | Laura | Elin | Ida | Suvi | Ola | Hala | Andres | Sergio | Remi | Adriano | Thiago | Ruth | Stephen | Kazuha | Tomoko | Niamh | Sofie | Lisa | Isabelle | Zayd | Danielle | Gregory | Burcu | Jitka | Sabrina | Jasmine | Jihye | Ambre | Beatrice | Florian | Lennart | Lorenzo | Tiffany`   
Wajib: Ya

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

Permintaan menerima data berikut dalam format JSON.

 ** [CloseStreamEvent](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-CloseStreamEvent"></a>
Peristiwa yang menunjukkan akhir aliran input.  
Tipe: Objek [CloseStreamEvent](API_CloseStreamEvent.md)  
Wajib: Tidak

 ** [TextEvent](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-TextEvent"></a>
Sebuah peristiwa teks yang berisi konten yang akan disintesis.  
Tipe: Objek [TextEvent](API_TextEvent.md)  
Wajib: Tidak

## Sintaksis Respons
<a name="API_StartSpeechSynthesisStream_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AudioEvent": { 
      "AudioChunk": blob
   },
   "ServiceFailureException": { 
   },
   "ServiceQuotaExceededException": { 
   },
   "StreamClosedEvent": { 
      "RequestCharacters": number
   },
   "ThrottlingException": { 
   },
   "ValidationException": { 
   }
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [AudioEvent](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-AudioEvent"></a>
Acara audio yang berisi pidato yang disintesis.  
Tipe: Objek [AudioEvent](API_AudioEvent.md)

 ** [ServiceFailureException](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-ServiceFailureException"></a>
Kondisi yang tidak diketahui telah menyebabkan kegagalan layanan.  
Jenis: Pengecualian  
Kode Status HTTP: 500

 ** [ServiceQuotaExceededException](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-ServiceQuotaExceededException"></a>
Pengecualian yang menunjukkan kuota layanan akan terlampaui.  
Jenis: Pengecualian  
Kode Status HTTP: 402

 ** [StreamClosedEvent](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-StreamClosedEvent"></a>
Sebuah peristiwa, dengan informasi ringkasan, yang menunjukkan aliran telah ditutup.  
Tipe: Objek [StreamClosedEvent](API_StreamClosedEvent.md)

 ** [ThrottlingException](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-ThrottlingException"></a>
Pengecualian yang menunjukkan permintaan dibatasi.  
Jenis: Pengecualian  
Kode Status HTTP: 400

 ** [ValidationException](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-ValidationException"></a>
Pengecualian yang menunjukkan validasi input gagal.  
Jenis: Pengecualian  
Kode Status HTTP: 400

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

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

 ** ServiceQuotaExceededException **   
Permintaan akan menyebabkan kuota layanan terlampaui.    
 ** quotaCode **   
Kode kuota mengidentifikasi kuota tertentu.  
 ** serviceCode **   
Kode layanan yang mengidentifikasi layanan asal.
Kode Status HTTP: 402

 ** ThrottlingException **   
Permintaan ditolak karena pembatasan permintaan.    
 ** throttlingReasons **   
Daftar alasan yang menjelaskan mengapa permintaan itu dibatasi.
Kode Status HTTP: 400

 ** ValidationException **   
Input gagal memenuhi kendala yang ditentukan oleh layanan.    
 ** fields **   
Bidang yang menyebabkan kesalahan validasi.  
 ** reason **   
Alasan permintaan gagal validasi.
Kode Status HTTP: 400

## Lihat Juga
<a name="API_StartSpeechSynthesisStream_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/StartSpeechSynthesisStream) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/StartSpeechSynthesisStream) 

# StartSpeechSynthesisTask
<a name="API_StartSpeechSynthesisTask"></a>

Memungkinkan pembuatan tugas sintesis asinkron, dengan memulai yang baru. `SpeechSynthesisTask` Operasi ini memerlukan semua informasi standar yang diperlukan untuk sintesis ucapan, ditambah nama bucket Amazon S3 untuk layanan untuk menyimpan output tugas sintesis dan dua parameter opsional (`OutputS3KeyPrefix`dan`SnsTopicArn`). Setelah tugas sintesis dibuat, operasi ini akan mengembalikan `SpeechSynthesisTask` objek, yang akan mencakup pengidentifikasi tugas ini serta status saat ini. `SpeechSynthesisTask`Objek tersedia selama 72 jam setelah memulai tugas sintesis asinkron.

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

```
POST /v1/synthesisTasks HTTP/1.1
Content-type: application/json

{
   "Engine": "string",
   "LanguageCode": "string",
   "LexiconNames": [ "string" ],
   "OutputFormat": "string",
   "OutputS3BucketName": "string",
   "OutputS3KeyPrefix": "string",
   "SampleRate": "string",
   "SnsTopicArn": "string",
   "SpeechMarkTypes": [ "string" ],
   "Text": "string",
   "TextType": "string",
   "VoiceId": "string"
}
```

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

Permintaan tidak menggunakan parameter URI apa pun.

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

Permintaan menerima data berikut dalam format JSON.

 ** [Engine](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-Engine"></a>
Menentukan mesin (`standard`,`neural`, `long-form` atau`generative`) untuk Amazon Polly untuk digunakan saat memproses teks input untuk sintesis ucapan. Menggunakan suara yang tidak didukung untuk mesin yang dipilih akan mengakibatkan kesalahan.  
Tipe: String  
Nilai yang Valid: `standard | neural | long-form | generative`   
Wajib: Tidak

 ** [LanguageCode](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-LanguageCode"></a>
Kode bahasa opsional untuk permintaan Sintesis Pidato. Ini hanya diperlukan jika menggunakan suara bilingual, seperti Aditi, yang dapat digunakan untuk bahasa Inggris India (En-in) atau Hindi (Hi-in).   
Jika suara dwibahasa digunakan dan tidak ada kode bahasa yang ditentukan, Amazon Polly menggunakan bahasa default suara dwibahasa. Bahasa default untuk suara apa pun adalah yang dikembalikan oleh [DescribeVoices](https://docs.aws.amazon.com/polly/latest/dg/API_DescribeVoices.html)operasi untuk `LanguageCode` parameter. Misalnya, jika tidak ada kode bahasa yang ditentukan, Aditi akan menggunakan bahasa Inggris India daripada bahasa Hindi.  
Tipe: String  
Nilai yang 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`   
Wajib: Tidak

 ** [LexiconNames](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-LexiconNames"></a>
Daftar satu atau lebih nama leksikon pengucapan yang Anda inginkan untuk diterapkan layanan selama sintesis. Leksikon diterapkan hanya jika bahasa leksikon sama dengan bahasa suara.   
Tipe: Array string  
Anggota Array: Jumlah maksimum 5 item.  
Pola: `[0-9A-Za-z]{1,20}`   
Wajib: Tidak

 ** [OutputFormat](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-OutputFormat"></a>
Format di mana output yang dikembalikan akan dikodekan. Untuk streaming audio, ini akan menjadi mp3, ogg\$1vorbis, ogg\$1opus, mu-law, a-law, atau pcm. Untuk tanda bicara, ini akan menjadi json.   
Tipe: String  
Nilai yang Valid: `json | mp3 | ogg_opus | ogg_vorbis | pcm`   
Wajib: Ya

 ** [OutputS3BucketName](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-OutputS3BucketName"></a>
Nama bucket Amazon S3 tempat file output akan disimpan.  
Tipe: String  
Pola: `^[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]$`   
Wajib: Ya

 ** [OutputS3KeyPrefix](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-OutputS3KeyPrefix"></a>
Awalan kunci Amazon S3 untuk file ucapan keluaran.  
Tipe: String  
Pola: `^[0-9a-zA-Z\/\!\-_\.\*\'\(\):;\$@=+\,\?&]{0,800}$`   
Wajib: Tidak

 ** [SampleRate](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-SampleRate"></a>
Frekuensi audio yang ditentukan dalam Hz.  
Nilai yang valid untuk mp3 dan ogg\$1vorbis adalah “8000", “16000", “22050", dan “24000". Nilai default untuk suara standar adalah “22050". Nilai default untuk suara saraf adalah “24000". Nilai default untuk suara bentuk panjang adalah “24000". Nilai default untuk suara generatif adalah “24000".  
Nilai yang valid untuk pcm adalah “8000" dan “16000" Nilai default adalah “16000".   
Nilai valid untuk ogg\$1opus adalah “48000".   
Nilai yang valid untuk mu-law dan a-law adalah “8000".   
Tipe: String  
Wajib: Tidak

 ** [SnsTopicArn](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-SnsTopicArn"></a>
ARN untuk topik SNS secara opsional digunakan untuk memberikan pemberitahuan status untuk tugas sintesis ucapan.  
Tipe: String  
Pola: `^arn:aws(-(cn|iso(-b)?|us-gov))?:sns:[a-z0-9_-]{1,50}:\d{12}:[a-zA-Z0-9_-]{1,251}([a-zA-Z0-9_-]{0,5}|\.fifo)$`   
Wajib: Tidak

 ** [SpeechMarkTypes](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-SpeechMarkTypes"></a>
Jenis tanda bicara yang dikembalikan untuk teks input.  
Tipe: Array string  
Anggota Array: Jumlah maksimum 4 item.  
Nilai yang Valid: `sentence | ssml | viseme | word`   
Wajib: Tidak

 ** [Text](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-Text"></a>
Teks masukan untuk mensintesis. Jika Anda menentukan ssml sebagai TextType, ikuti format SSML untuk teks input.   
Tipe: String  
Diperlukan: Ya

 ** [TextType](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-TextType"></a>
Menentukan apakah teks input adalah teks biasa atau SSML. Nilai defaultnya adalah teks biasa.   
Tipe: String  
Nilai yang Valid: `ssml | text`   
Wajib: Tidak

 ** [VoiceId](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-VoiceId"></a>
ID suara untuk digunakan untuk sintesis.   
Tipe: String  
Nilai yang Valid: `Aditi | Amy | Astrid | Bianca | Brian | Camila | Carla | Carmen | Celine | Chantal | Conchita | Cristiano | Dora | Emma | Enrique | Ewa | Filiz | Gabrielle | Geraint | Giorgio | Gwyneth | Hans | Ines | Ivy | Jacek | Jan | Joanna | Joey | Justin | Karl | Kendra | Kevin | Kimberly | Lea | Liv | Lotte | Lucia | Lupe | Mads | Maja | Marlene | Mathieu | Matthew | Maxim | Mia | Miguel | Mizuki | Naja | Nicole | Olivia | Penelope | Raveena | Ricardo | Ruben | Russell | Salli | Seoyeon | Takumi | Tatyana | Vicki | Vitoria | Zeina | Zhiyu | Aria | Ayanda | Arlet | Hannah | Arthur | Daniel | Liam | Pedro | Kajal | Hiujin | Laura | Elin | Ida | Suvi | Ola | Hala | Andres | Sergio | Remi | Adriano | Thiago | Ruth | Stephen | Kazuha | Tomoko | Niamh | Sofie | Lisa | Isabelle | Zayd | Danielle | Gregory | Burcu | Jitka | Sabrina | Jasmine | Jihye | Ambre | Beatrice | Florian | Lennart | Lorenzo | Tiffany`   
Wajib: Ya

## Sintaksis Respons
<a name="API_StartSpeechSynthesisTask_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "SynthesisTask": { 
      "CreationTime": number,
      "Engine": "string",
      "LanguageCode": "string",
      "LexiconNames": [ "string" ],
      "OutputFormat": "string",
      "OutputUri": "string",
      "RequestCharacters": number,
      "SampleRate": "string",
      "SnsTopicArn": "string",
      "SpeechMarkTypes": [ "string" ],
      "TaskId": "string",
      "TaskStatus": "string",
      "TaskStatusReason": "string",
      "TextType": "string",
      "VoiceId": "string"
   }
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [SynthesisTask](#API_StartSpeechSynthesisTask_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisTask-response-SynthesisTask"></a>
SynthesisTask objek yang memberikan informasi dan atribut tentang tugas sintesis ucapan yang baru dikirimkan.  
Tipe: Objek [SynthesisTask](API_SynthesisTask.md)

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

 ** EngineNotSupportedException **   
Mesin ini tidak kompatibel dengan suara yang Anda tunjuk. Pilih suara baru yang kompatibel dengan mesin atau ganti mesin dan nyalakan kembali operasi.  
Kode Status HTTP: 400

 ** InvalidS3BucketException **   
Nama bucket Amazon S3 yang disediakan tidak valid. Silakan periksa masukan Anda dengan persyaratan penamaan bucket S3 dan coba lagi.  
Kode Status HTTP: 400

 ** InvalidS3KeyException **   
Awalan key Amazon S3 yang disediakan tidak valid. Harap berikan nama kunci objek S3 yang valid.  
Kode Status HTTP: 400

 ** InvalidSampleRateException **   
Tingkat sampel yang ditentukan tidak valid.  
Kode Status HTTP: 400

 ** InvalidSnsTopicArnException **   
Topik SNS yang disediakan ARN tidak valid. Harap berikan ARN topik SNS yang valid dan coba lagi.  
Kode Status HTTP: 400

 ** InvalidSsmlException **   
SSML yang Anda berikan tidak valid. Verifikasi sintaks SSML, ejaan tag dan nilai, lalu coba lagi.  
Kode Status HTTP: 400

 ** LanguageNotSupportedException **   
Bahasa yang ditentukan saat ini tidak didukung oleh Amazon Polly dalam kapasitas ini.  
Kode Status HTTP: 400

 ** LexiconNotFoundException **   
Amazon Polly tidak dapat menemukan leksikon yang ditentukan. Ini bisa disebabkan oleh leksikon yang hilang, namanya salah eja atau menentukan leksikon yang ada di wilayah berbeda.  
Verifikasi bahwa leksikon ada, ada di wilayah (lihat[ListLexicons](API_ListLexicons.md)) dan Anda mengeja namanya dieja dengan benar. Kemudian coba lagi.  
Kode Status HTTP: 404

 ** MarksNotSupportedForFormatException **   
Tanda ucapan tidak didukung untuk yang `OutputFormat` dipilih. Tanda ucapan hanya tersedia untuk konten dalam `json` format.  
Kode Status HTTP: 400

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

 ** SsmlMarksNotSupportedForTextTypeException **   
Tanda ucapan SSML tidak didukung untuk input tipe teks biasa.  
Kode Status HTTP: 400

 ** TextLengthExceededException **   
Nilai parameter “Teks” lebih panjang dari batas yang diterima. Untuk `SynthesizeSpeech` API, batas untuk teks input adalah maksimum 6000 karakter total, yang tidak lebih dari 3000 karakter dapat ditagih. Untuk `StartSpeechSynthesisTask` API, maksimum adalah 200.000 karakter, yang tidak lebih dari 100.000 karakter dapat ditagih. Tag SSML tidak dihitung sebagai karakter yang ditagih.  
Kode Status HTTP: 400

## Lihat Juga
<a name="API_StartSpeechSynthesisTask_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/StartSpeechSynthesisTask) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/StartSpeechSynthesisTask) 

# SynthesizeSpeech
<a name="API_SynthesizeSpeech"></a>

Mensintesis input UTF-8, teks biasa atau SSML, ke aliran byte. Masukan SSML harus valid, SSML yang terbentuk dengan baik. Beberapa huruf mungkin tidak tersedia dengan semua suara (misalnya, Cyrillic mungkin tidak dibaca sama sekali oleh suara bahasa Inggris) kecuali pemetaan fonem digunakan. Untuk informasi selengkapnya, lihat [Cara Kerjanya](https://docs.aws.amazon.com/polly/latest/dg/how-text-to-speech-works.html).

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

```
POST /v1/speech HTTP/1.1
Content-type: application/json

{
   "Engine": "string",
   "LanguageCode": "string",
   "LexiconNames": [ "string" ],
   "OutputFormat": "string",
   "SampleRate": "string",
   "SpeechMarkTypes": [ "string" ],
   "Text": "string",
   "TextType": "string",
   "VoiceId": "string"
}
```

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

Permintaan tidak menggunakan parameter URI apa pun.

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

Permintaan menerima data berikut dalam format JSON.

 ** [Engine](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-Engine"></a>
Menentukan mesin (`standard`,, `neural``long-form`, atau`generative`) untuk Amazon Polly untuk digunakan saat memproses teks input untuk sintesis ucapan. Sediakan mesin yang didukung oleh suara yang Anda pilih. Jika Anda tidak menyediakan mesin, mesin standar dipilih secara default. Jika suara yang dipilih tidak didukung oleh mesin standar, ini akan mengakibatkan kesalahan. [Untuk informasi tentang suara Amazon Polly dan suara mana yang tersedia untuk setiap mesin, lihat Suara yang Tersedia.](https://docs.aws.amazon.com/polly/latest/dg/voicelist.html)  
Tipe: String  
Nilai yang Valid: `standard | neural | long-form | generative`   
Wajib: Tidak

 ** [LanguageCode](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-LanguageCode"></a>
Kode bahasa opsional untuk permintaan Synthesize Speech. Ini hanya diperlukan jika menggunakan suara bilingual, seperti Aditi, yang dapat digunakan untuk bahasa Inggris India (En-in) atau Hindi (Hi-in).   
Jika suara bilingual digunakan dan tidak ada kode bahasa yang ditentukan, Amazon Polly menggunakan bahasa default suara dwibahasa. Bahasa default untuk suara apa pun adalah yang dikembalikan oleh [DescribeVoices](https://docs.aws.amazon.com/polly/latest/dg/API_DescribeVoices.html)operasi untuk `LanguageCode` parameter. Misalnya, jika tidak ada kode bahasa yang ditentukan, Aditi akan menggunakan bahasa Inggris India daripada bahasa Hindi.  
Tipe: String  
Nilai yang 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`   
Wajib: Tidak

 ** [LexiconNames](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-LexiconNames"></a>
Daftar satu atau lebih nama leksikon pengucapan yang Anda inginkan untuk diterapkan layanan selama sintesis. Leksikon diterapkan hanya jika bahasa leksikon sama dengan bahasa suara. Untuk informasi tentang menyimpan leksikon, lihat [PutLexicon](https://docs.aws.amazon.com/polly/latest/dg/API_PutLexicon.html).  
Tipe: Array string  
Anggota Array: Jumlah maksimum 5 item.  
Pola: `[0-9A-Za-z]{1,20}`   
Wajib: Tidak

 ** [OutputFormat](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-OutputFormat"></a>
 Format di mana output yang dikembalikan akan dikodekan. Untuk streaming audio, ini akan menjadi mp3, ogg\$1vorbis, ogg\$1opus, mu-law, a-law atau pcm. Untuk tanda bicara, ini akan menjadi json.   
Saat pcm digunakan, konten yang dikembalikan audio/pcm dalam format 16-bit, 1 saluran (mono), endian kecil yang ditandatangani.   
Tipe: String  
Nilai yang Valid: `json | mp3 | ogg_opus | ogg_vorbis | pcm`   
Wajib: Ya

 ** [SampleRate](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-SampleRate"></a>
Frekuensi audio yang ditentukan dalam Hz.  
Nilai yang valid untuk mp3 dan ogg\$1vorbis adalah “8000", “16000", “22050", “24000", “44100" dan “48000". Nilai default untuk suara standar adalah “22050". Nilai default untuk suara saraf adalah “24000". Nilai default untuk suara bentuk panjang adalah “24000". Nilai default untuk suara generatif adalah “24000".  
Nilai yang valid untuk pcm adalah “8000" dan “16000" Nilai default adalah “16000".   
Nilai valid untuk ogg\$1opus adalah “48000".   
Nilai yang valid untuk mu-law dan a-law adalah “8000".   
Tipe: String  
Wajib: Tidak

 ** [SpeechMarkTypes](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-SpeechMarkTypes"></a>
Jenis tanda bicara yang dikembalikan untuk teks input.  
Tipe: Array string  
Anggota Array: Jumlah maksimum 4 item.  
Nilai yang Valid: `sentence | ssml | viseme | word`   
Wajib: Tidak

 ** [Text](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-Text"></a>
 Masukan teks untuk mensintesis. Jika Anda menentukan `ssml` sebagai`TextType`, ikuti format SSML untuk teks input.   
Tipe: String  
Diperlukan: Ya

 ** [TextType](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-TextType"></a>
 Menentukan apakah teks input adalah teks biasa atau SSML. Nilai default adalah teks biasa. Untuk informasi selengkapnya, lihat [Menggunakan SSML](https://docs.aws.amazon.com/polly/latest/dg/ssml.html).  
Tipe: String  
Nilai yang Valid: `ssml | text`   
Wajib: Tidak

 ** [VoiceId](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-VoiceId"></a>
 ID suara untuk digunakan untuk sintesis. Anda bisa mendapatkan daftar suara yang tersedia IDs dengan memanggil [DescribeVoices](https://docs.aws.amazon.com/polly/latest/dg/API_DescribeVoices.html)operasi.   
Tipe: String  
Nilai yang Valid: `Aditi | Amy | Astrid | Bianca | Brian | Camila | Carla | Carmen | Celine | Chantal | Conchita | Cristiano | Dora | Emma | Enrique | Ewa | Filiz | Gabrielle | Geraint | Giorgio | Gwyneth | Hans | Ines | Ivy | Jacek | Jan | Joanna | Joey | Justin | Karl | Kendra | Kevin | Kimberly | Lea | Liv | Lotte | Lucia | Lupe | Mads | Maja | Marlene | Mathieu | Matthew | Maxim | Mia | Miguel | Mizuki | Naja | Nicole | Olivia | Penelope | Raveena | Ricardo | Ruben | Russell | Salli | Seoyeon | Takumi | Tatyana | Vicki | Vitoria | Zeina | Zhiyu | Aria | Ayanda | Arlet | Hannah | Arthur | Daniel | Liam | Pedro | Kajal | Hiujin | Laura | Elin | Ida | Suvi | Ola | Hala | Andres | Sergio | Remi | Adriano | Thiago | Ruth | Stephen | Kazuha | Tomoko | Niamh | Sofie | Lisa | Isabelle | Zayd | Danielle | Gregory | Burcu | Jitka | Sabrina | Jasmine | Jihye | Ambre | Beatrice | Florian | Lennart | Lorenzo | Tiffany`   
Wajib: Ya

## Sintaksis Respons
<a name="API_SynthesizeSpeech_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-Type: ContentType
x-amzn-RequestCharacters: RequestCharacters

AudioStream
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Respons mengembalikan header HTTP berikut.

 ** [ContentType](#API_SynthesizeSpeech_ResponseSyntax) **   <a name="polly-SynthesizeSpeech-response-ContentType"></a>
 Menentukan jenis aliran audio. Ini harus mencerminkan `OutputFormat` parameter dalam permintaan Anda.   
+  Jika Anda meminta `mp3` sebagai`OutputFormat`, yang `ContentType` dikembalikan adalah audio/mpeg. 
+  Jika Anda meminta `ogg_vorbis` sebagai`OutputFormat`, yang `ContentType` dikembalikan adalah audio/ogg. 
+  Jika Anda meminta `ogg_opus` sebagai`OutputFormat`, yang `ContentType` dikembalikan adalah audio/ogg. 
+  Jika Anda meminta `pcm` sebagai`OutputFormat`, yang `ContentType` dikembalikan audio/pcm dalam format 16-bit, 1 saluran (mono), endian kecil yang ditandatangani. 
+  Jika Anda meminta `mu-law` sebagai`OutputFormat`, yang `ContentType` dikembalikan adalah audio/mulaw. 
+  Jika Anda meminta `a-law` sebagai`OutputFormat`, yang `ContentType` dikembalikan adalah audio/alaw. 
+ Jika Anda meminta `json` sebagai`OutputFormat`, yang `ContentType` dikembalikan adalah aplikasi/x-json-stream.
 

 ** [RequestCharacters](#API_SynthesizeSpeech_ResponseSyntax) **   <a name="polly-SynthesizeSpeech-response-RequestCharacters"></a>
Jumlah karakter yang disintesis.

Respons mengembalikan yang berikut sebagai isi HTTP.

 ** [AudioStream](#API_SynthesizeSpeech_ResponseSyntax) **   <a name="polly-SynthesizeSpeech-response-AudioStream"></a>
 Aliran yang berisi pidato yang disintesis. 

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

 ** EngineNotSupportedException **   
Mesin ini tidak kompatibel dengan suara yang Anda tunjuk. Pilih suara baru yang kompatibel dengan mesin atau ganti mesin dan nyalakan kembali operasi.  
Kode Status HTTP: 400

 ** InvalidSampleRateException **   
Tingkat sampel yang ditentukan tidak valid.  
Kode Status HTTP: 400

 ** InvalidSsmlException **   
SSML yang Anda berikan tidak valid. Verifikasi sintaks SSML, ejaan tag dan nilai, lalu coba lagi.  
Kode Status HTTP: 400

 ** LanguageNotSupportedException **   
Bahasa yang ditentukan saat ini tidak didukung oleh Amazon Polly dalam kapasitas ini.  
Kode Status HTTP: 400

 ** LexiconNotFoundException **   
Amazon Polly tidak dapat menemukan leksikon yang ditentukan. Ini bisa disebabkan oleh leksikon yang hilang, namanya salah eja atau menentukan leksikon yang ada di wilayah berbeda.  
Verifikasi bahwa leksikon ada, ada di wilayah (lihat[ListLexicons](API_ListLexicons.md)) dan Anda mengeja namanya dieja dengan benar. Kemudian coba lagi.  
Kode Status HTTP: 404

 ** MarksNotSupportedForFormatException **   
Tanda ucapan tidak didukung untuk yang `OutputFormat` dipilih. Tanda ucapan hanya tersedia untuk konten dalam `json` format.  
Kode Status HTTP: 400

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

 ** SsmlMarksNotSupportedForTextTypeException **   
Tanda ucapan SSML tidak didukung untuk input tipe teks biasa.  
Kode Status HTTP: 400

 ** TextLengthExceededException **   
Nilai parameter “Teks” lebih panjang dari batas yang diterima. Untuk `SynthesizeSpeech` API, batas untuk teks input adalah maksimum 6000 karakter total, yang tidak lebih dari 3000 karakter dapat ditagih. Untuk `StartSpeechSynthesisTask` API, maksimum adalah 200.000 karakter, yang tidak lebih dari 100.000 karakter dapat ditagih. Tag SSML tidak dihitung sebagai karakter yang ditagih.  
Kode Status HTTP: 400

## Lihat Juga
<a name="API_SynthesizeSpeech_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/SynthesizeSpeech) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/SynthesizeSpeech)