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

# 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 | mulaw | alaw`   
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)