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

# Referensi API Amazon Polly
<a name="API_Reference"></a>

Amazon Polly adalah layanan web yang memudahkan untuk mensintesis ucapan dari teks.

Layanan Amazon Polly menyediakan operasi API untuk mensintesis ucapan berkualitas tinggi dari teks biasa dan Speech Synthesis Markup Language (SSML), bersama dengan mengelola leksikon pengucapan yang memungkinkan Anda mendapatkan hasil terbaik untuk domain aplikasi Anda.

Panggilan API yang diautentikasi harus ditandatangani menggunakan Proses Penandatanganan Versi Tanda Tangan 4. Untuk informasi selengkapnya, lihat [Menandatangani Permintaan AWS API](https://docs.aws.amazon.com/general/latest/gr/signing_aws_api_requests.html) di bagian *Referensi Umum Amazon Web Services*.

**Topics**
+ [

# Tindakan
](API_Operations.md)
+ [

# Tipe Data
](API_Types.md)
+ [

# Kesalahan Umum
](CommonErrors.md)
+ [

# Parameter Umum
](CommonParameters.md)

# 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) 

# Tipe Data
<a name="API_Types"></a>

tipe data berikut didukung:
+  [AudioEvent](API_AudioEvent.md) 
+  [CloseStreamEvent](API_CloseStreamEvent.md) 
+  [FlushStreamConfiguration](API_FlushStreamConfiguration.md) 
+  [Lexicon](API_Lexicon.md) 
+  [LexiconAttributes](API_LexiconAttributes.md) 
+  [LexiconDescription](API_LexiconDescription.md) 
+  [StartSpeechSynthesisStreamActionStream](API_StartSpeechSynthesisStreamActionStream.md) 
+  [StartSpeechSynthesisStreamEventStream](API_StartSpeechSynthesisStreamEventStream.md) 
+  [StreamClosedEvent](API_StreamClosedEvent.md) 
+  [SynthesisTask](API_SynthesisTask.md) 
+  [TextEvent](API_TextEvent.md) 
+  [ThrottlingReason](API_ThrottlingReason.md) 
+  [ValidationExceptionField](API_ValidationExceptionField.md) 
+  [Voice](API_Voice.md) 

# AudioEvent
<a name="API_AudioEvent"></a>

Berisi sepotong data audio yang disintesis.

## Daftar Isi
<a name="API_AudioEvent_Contents"></a>

 ** AudioChunk **   <a name="polly-Type-AudioEvent-AudioChunk"></a>
Sepotong data audio yang disintesis dikodekan dalam format yang ditentukan oleh parameter. `OutputFormat`  
Tipe: Objek data biner berkode Base64  
Wajib: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/AudioEvent) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/AudioEvent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/AudioEvent) 

# CloseStreamEvent
<a name="API_CloseStreamEvent"></a>

Menunjukkan akhir aliran input. Setelah mengirim acara ini, aliran input akan ditutup dan semua audio akan dikembalikan.

## Daftar Isi
<a name="API_CloseStreamEvent_Contents"></a>

Anggota struktur pengecualian ini bergantung pada konteks.

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/CloseStreamEvent) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/CloseStreamEvent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/CloseStreamEvent) 

# FlushStreamConfiguration
<a name="API_FlushStreamConfiguration"></a>

Konfigurasi yang mengontrol saat data audio yang disintesis dikirim pada aliran output.

## Daftar Isi
<a name="API_FlushStreamConfiguration_Contents"></a>

 ** Force **   <a name="polly-Type-FlushStreamConfiguration-Force"></a>
Menentukan apakah akan memaksa mesin sintesis untuk segera menulis data audio buffer ke aliran output.  
Tipe: Boolean  
Wajib: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/FlushStreamConfiguration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/FlushStreamConfiguration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/FlushStreamConfiguration) 

# Lexicon
<a name="API_Lexicon"></a>

Menyediakan nama leksikon dan konten leksikon dalam format string. Untuk informasi selengkapnya, lihat [Spesifikasi Leksikon Pengucapan (PLS) Versi 1.0](https://www.w3.org/TR/pronunciation-lexicon/).

## Daftar Isi
<a name="API_Lexicon_Contents"></a>

 ** Content **   <a name="polly-Type-Lexicon-Content"></a>
Konten leksikon dalam format string. Isi leksikon harus dalam format PLS.  
Tipe: String  
Wajib: Tidak

 ** Name **   <a name="polly-Type-Lexicon-Name"></a>
Nama leksikon.  
Tipe: String  
Pola: `[0-9A-Za-z]{1,20}`   
Diperlukan: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/Lexicon) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/Lexicon) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/Lexicon) 

# LexiconAttributes
<a name="API_LexiconAttributes"></a>

Berisi metadata yang menggambarkan leksikon seperti jumlah leksem, kode bahasa, dan sebagainya. Untuk informasi selengkapnya, lihat [Mengelola Leksikon](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html).

## Daftar Isi
<a name="API_LexiconAttributes_Contents"></a>

 ** Alphabet **   <a name="polly-Type-LexiconAttributes-Alphabet"></a>
Alfabet fonetik yang digunakan dalam leksikon. Nilai yang valid adalah `ipa` dan `x-sampa`.  
Tipe: String  
Wajib: Tidak

 ** LanguageCode **   <a name="polly-Type-LexiconAttributes-LanguageCode"></a>
Kode bahasa yang berlaku untuk leksikon. Sebuah leksikon dengan kode bahasa seperti “en” akan diterapkan ke semua bahasa Inggris (en-GB, en-US, en-AUS, en-WLS, dan sebagainya.  
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

 ** LastModified **   <a name="polly-Type-LexiconAttributes-LastModified"></a>
Leksikon tanggal terakhir diubah (nilai stempel waktu).  
Tipe: Timestamp  
Wajib: Tidak

 ** LexemesCount **   <a name="polly-Type-LexiconAttributes-LexemesCount"></a>
Jumlah leksem dalam leksikon.  
Tipe: Integer  
Wajib: Tidak

 ** LexiconArn **   <a name="polly-Type-LexiconAttributes-LexiconArn"></a>
Nama Sumber Daya Amazon (ARN) dari leksikon.  
Tipe: String  
Wajib: Tidak

 ** Size **   <a name="polly-Type-LexiconAttributes-Size"></a>
Ukuran total leksikon, dalam karakter.  
Tipe: Integer  
Wajib: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/LexiconAttributes) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/LexiconAttributes) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/LexiconAttributes) 

# LexiconDescription
<a name="API_LexiconDescription"></a>

Menjelaskan isi leksikon.

## Daftar Isi
<a name="API_LexiconDescription_Contents"></a>

 ** Attributes **   <a name="polly-Type-LexiconDescription-Attributes"></a>
Menyediakan metadata leksikon.  
Tipe: Objek [LexiconAttributes](API_LexiconAttributes.md)  
Wajib: Tidak

 ** Name **   <a name="polly-Type-LexiconDescription-Name"></a>
Nama leksikon.  
Tipe: String  
Pola: `[0-9A-Za-z]{1,20}`   
Diperlukan: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/LexiconDescription) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/LexiconDescription) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/LexiconDescription) 

# StartSpeechSynthesisStreamActionStream
<a name="API_StartSpeechSynthesisStreamActionStream"></a>

Aliran acara masuk untuk mengirim input dan acara kontrol untuk mengelola sintesis ucapan dua arah.

## Daftar Isi
<a name="API_StartSpeechSynthesisStreamActionStream_Contents"></a>

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

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

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/StartSpeechSynthesisStreamActionStream) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/StartSpeechSynthesisStreamActionStream) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/StartSpeechSynthesisStreamActionStream) 

# StartSpeechSynthesisStreamEventStream
<a name="API_StartSpeechSynthesisStreamEventStream"></a>

Aliran peristiwa keluar yang berisi data audio yang disintesis dan peristiwa status aliran.

## Daftar Isi
<a name="API_StartSpeechSynthesisStreamEventStream_Contents"></a>

 ** AudioEvent **   <a name="polly-Type-StartSpeechSynthesisStreamEventStream-AudioEvent"></a>
Acara audio yang berisi pidato yang disintesis.  
Tipe: Objek [AudioEvent](API_AudioEvent.md)  
Wajib: Tidak

 ** ServiceFailureException **   <a name="polly-Type-StartSpeechSynthesisStreamEventStream-ServiceFailureException"></a>
Kondisi yang tidak diketahui telah menyebabkan kegagalan layanan.  
Jenis: Pengecualian  
Kode Status HTTP: 500  
Wajib: Tidak

 ** ServiceQuotaExceededException **   <a name="polly-Type-StartSpeechSynthesisStreamEventStream-ServiceQuotaExceededException"></a>
Pengecualian yang menunjukkan kuota layanan akan terlampaui.  
Jenis: Pengecualian  
Kode Status HTTP: 402  
Wajib: Tidak

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

 ** ThrottlingException **   <a name="polly-Type-StartSpeechSynthesisStreamEventStream-ThrottlingException"></a>
Pengecualian yang menunjukkan permintaan dibatasi.  
Jenis: Pengecualian  
Kode Status HTTP: 400  
Wajib: Tidak

 ** ValidationException **   <a name="polly-Type-StartSpeechSynthesisStreamEventStream-ValidationException"></a>
Pengecualian yang menunjukkan validasi input gagal.  
Jenis: Pengecualian  
Kode Status HTTP: 400  
Wajib: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/StartSpeechSynthesisStreamEventStream) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/StartSpeechSynthesisStreamEventStream) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/StartSpeechSynthesisStreamEventStream) 

# StreamClosedEvent
<a name="API_StreamClosedEvent"></a>

Menunjukkan bahwa aliran sintesis ditutup dan memberikan informasi ringkasan.

## Daftar Isi
<a name="API_StreamClosedEvent_Contents"></a>

 ** RequestCharacters **   <a name="polly-Type-StreamClosedEvent-RequestCharacters"></a>
Jumlah total karakter yang disintesis selama sesi streaming.  
Tipe: Integer  
Wajib: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/StreamClosedEvent) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/StreamClosedEvent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/StreamClosedEvent) 

# SynthesisTask
<a name="API_SynthesisTask"></a>

SynthesisTask objek yang memberikan informasi tentang tugas sintesis ucapan.

## Daftar Isi
<a name="API_SynthesisTask_Contents"></a>

 ** CreationTime **   <a name="polly-Type-SynthesisTask-CreationTime"></a>
Stempel waktu untuk saat tugas sintesis dimulai.  
Tipe: Timestamp  
Wajib: Tidak

 ** Engine **   <a name="polly-Type-SynthesisTask-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 **   <a name="polly-Type-SynthesisTask-LanguageCode"></a>
Kode bahasa opsional untuk tugas sintesis. 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 **   <a name="polly-Type-SynthesisTask-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 **   <a name="polly-Type-SynthesisTask-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: Tidak

 ** OutputUri **   <a name="polly-Type-SynthesisTask-OutputUri"></a>
Jalur untuk file ucapan keluaran.  
Tipe: String  
Wajib: Tidak

 ** RequestCharacters **   <a name="polly-Type-SynthesisTask-RequestCharacters"></a>
Jumlah karakter yang dapat ditagih disintesis.  
Tipe: Integer  
Wajib: Tidak

 ** SampleRate **   <a name="polly-Type-SynthesisTask-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 **   <a name="polly-Type-SynthesisTask-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 **   <a name="polly-Type-SynthesisTask-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

 ** TaskId **   <a name="polly-Type-SynthesisTask-TaskId"></a>
Amazon Polly menghasilkan pengidentifikasi untuk tugas sintesis ucapan.  
Tipe: String  
Pola: `^[a-zA-Z0-9_-]{1,100}$`   
Wajib: Tidak

 ** TaskStatus **   <a name="polly-Type-SynthesisTask-TaskStatus"></a>
Status saat ini dari tugas sintesis ucapan individu.  
Tipe: String  
Nilai yang Valid: `scheduled | inProgress | completed | failed`   
Wajib: Tidak

 ** TaskStatusReason **   <a name="polly-Type-SynthesisTask-TaskStatusReason"></a>
Alasan status saat ini dari tugas sintesis ucapan tertentu, termasuk kesalahan jika tugas gagal.  
Tipe: String  
Wajib: Tidak

 ** TextType **   <a name="polly-Type-SynthesisTask-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 **   <a name="polly-Type-SynthesisTask-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: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/SynthesisTask) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/SynthesisTask) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/SynthesisTask) 

# TextEvent
<a name="API_TextEvent"></a>

Berisi konten teks untuk disintesis menjadi ucapan.

## Daftar Isi
<a name="API_TextEvent_Contents"></a>

 ** Text **   <a name="polly-Type-TextEvent-Text"></a>
Konten teks untuk disintesis. Jika Anda menentukan `ssml` sebagai`TextType`, ikuti format SSML untuk teks input.  
Tipe: String  
Diperlukan: Ya

 ** FlushStreamConfiguration **   <a name="polly-Type-TextEvent-FlushStreamConfiguration"></a>
Konfigurasi untuk mengontrol saat audio yang disintesis disiram ke aliran output.  
Tipe: Objek [FlushStreamConfiguration](API_FlushStreamConfiguration.md)  
Wajib: Tidak

 ** TextType **   <a name="polly-Type-TextEvent-TextType"></a>
Menentukan apakah teks input adalah teks biasa atau SSML. Default: teks biasa.  
Tipe: String  
Nilai yang Valid: `ssml | text`   
Wajib: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/TextEvent) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/TextEvent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/TextEvent) 

# ThrottlingReason
<a name="API_ThrottlingReason"></a>

Memberikan informasi tentang alasan pelambatan tertentu.

## Daftar Isi
<a name="API_ThrottlingReason_Contents"></a>

 ** reason **   <a name="polly-Type-ThrottlingReason-reason"></a>
Kode alasan menjelaskan mengapa permintaan itu dibatasi.  
Tipe: String  
Wajib: Tidak

 ** resource **   <a name="polly-Type-ThrottlingReason-resource"></a>
Sumber daya yang menyebabkan pelambatan.  
Tipe: String  
Wajib: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/ThrottlingReason) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/ThrottlingReason) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/ThrottlingReason) 

# ValidationExceptionField
<a name="API_ValidationExceptionField"></a>

Informasi tentang bidang yang gagal validasi.

## Daftar Isi
<a name="API_ValidationExceptionField_Contents"></a>

 ** message **   <a name="polly-Type-ValidationExceptionField-message"></a>
Pesan yang menjelaskan mengapa bidang gagal validasi.  
Tipe: String  
Diperlukan: Ya

 ** name **   <a name="polly-Type-ValidationExceptionField-name"></a>
Nama bidang yang gagal validasi.  
Tipe: String  
Wajib: Ya

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/ValidationExceptionField) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/ValidationExceptionField) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/ValidationExceptionField) 

# Voice
<a name="API_Voice"></a>

Deskripsi suara.

## Daftar Isi
<a name="API_Voice_Contents"></a>

 ** AdditionalLanguageCodes **   <a name="polly-Type-Voice-AdditionalLanguageCodes"></a>
Kode tambahan untuk bahasa yang tersedia untuk suara yang ditentukan selain bahasa defaultnya.   
Misalnya, bahasa default untuk Aditi adalah bahasa Inggris India (en-in) karena pertama kali digunakan untuk bahasa itu. Karena Aditi bilingual dan fasih dalam bahasa Inggris India dan Hindi, parameter ini akan menunjukkan kode. `hi-IN`  
Tipe: Array 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

 ** Gender **   <a name="polly-Type-Voice-Gender"></a>
Jenis kelamin suara.  
Tipe: String  
Nilai yang Valid: `Female | Male`   
Wajib: Tidak

 ** Id **   <a name="polly-Type-Voice-Id"></a>
Amazon Polly menetapkan ID suara. Ini adalah ID yang Anda tentukan saat memanggil `SynthesizeSpeech` 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: Tidak

 ** LanguageCode **   <a name="polly-Type-Voice-LanguageCode"></a>
Kode bahasa suara.  
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

 ** LanguageName **   <a name="polly-Type-Voice-LanguageName"></a>
Nama bahasa yang dapat dibaca manusia dalam bahasa Inggris.  
Tipe: String  
Wajib: Tidak

 ** Name **   <a name="polly-Type-Voice-Name"></a>
Nama suara (misalnya, Salli, Kendra, dll.). Ini memberikan nama suara yang dapat dibaca manusia yang mungkin Anda tampilkan di aplikasi Anda.  
Tipe: String  
Wajib: Tidak

 ** SupportedEngines **   <a name="polly-Type-Voice-SupportedEngines"></a>
Menentukan mesin mana (`standard`,`neural`, `long-form` atau`generative`) yang didukung oleh suara yang diberikan.  
Tipe: Array string  
Nilai yang Valid: `standard | neural | long-form | generative`   
Wajib: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/Voice) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/Voice) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/Voice) 

# Kesalahan Umum
<a name="CommonErrors"></a>

Bagian ini mencantumkan kesalahan yang umum terjadi pada tindakan API dari semua AWS layanan. Untuk kesalahan khusus pada tindakan API untuk layanan ini, lihat topik untuk tindakan API tersebut.

 **AccessDeniedException**   
Anda tidak memiliki akses yang memadai untuk melakukan tindakan ini.  
Kode Status HTTP: 400

 **IncompleteSignature**   
Tanda tangan permintaan tidak sesuai dengan AWS standar.  
Kode Status HTTP: 400

 **InternalFailure**   <a name="CommonErrors-InternalFailure"></a>
Pemrosesan permintaan telah gagal karena kesalahan yang tidak diketahui, pengecualian atau kegagalan.  
Kode Status HTTP: 500

 **InvalidAction**   <a name="CommonErrors-InvalidAction"></a>
Tindakan atau operasi yang diminta tidak valid. Verifikasi bahwa tindakan diketik dengan benar.  
Kode Status HTTP: 400

 **InvalidClientTokenId**   <a name="CommonErrors-InvalidClientTokenId"></a>
Sertifikat X.509 atau ID kunci AWS akses yang disediakan tidak ada dalam catatan kami.  
Kode Status HTTP: 403

 **NotAuthorized**   <a name="CommonErrors-NotAuthorized"></a>
Anda tidak memiliki izin untuk melakukan tindakan ini.  
Kode Status HTTP: 400

 **OptInRequired**   <a name="CommonErrors-OptInRequired"></a>
ID kunci AWS akses memerlukan langganan untuk layanan ini.  
Kode Status HTTP: 403

 **RequestExpired**   <a name="CommonErrors-RequestExpired"></a>
Permintaan mencapai layanan lebih dari 15 menit setelah cap tanggal pada permintaan atau lebih dari 15 menit setelah tanggal kedaluwarsa permintaan (seperti untuk pra-ditandatangani URLs), atau cap tanggal pada permintaan lebih dari 15 menit di masa depan.  
Kode Status HTTP: 400

 **ServiceUnavailable**   <a name="CommonErrors-ServiceUnavailable"></a>
Permintaan telah gagal karena kegagalan sementara server.  
Kode Status HTTP: 503

 **ThrottlingException**   <a name="CommonErrors-ThrottlingException"></a>
Permintaan ditolak karena throttling permintaan.  
Kode Status HTTP: 400

 **ValidationError**   <a name="CommonErrors-ValidationError"></a>
Input gagal memenuhi kendala yang ditentukan oleh layanan. AWS   
Kode Status HTTP: 400

# Parameter Umum
<a name="CommonParameters"></a>

Daftar berikut berisi parameter yang digunakan semua tindakan untuk menandatangani permintaan Tanda Tangan Versi 4 dengan string kueri. Setiap parameter khusus tindakan tercantum dalam topik untuk tindakan tersebut. Untuk informasi selengkapnya tentang Tanda Tangan Versi 4, lihat [Menandatangani permintaan AWS API](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) di *Panduan Pengguna IAM*.

 **X-Amz-Algorithm**   <a name="CommonParameters-X-Amz-Algorithm"></a>
Algoritme hash yang Anda gunakan untuk membuat tanda tangan permintaan.  
Syarat: Tentukan parameter ini ketika Anda menyertakan informasi autentikasi dalam string kueri alih-alih di header otorisasi HTTP.  
Tipe: string  
Nilai yang Valid: `AWS4-HMAC-SHA256`   
Diperlukan: Kondisional

 **X-Amz-Credential**   <a name="CommonParameters-X-Amz-Credential"></a>
Nilai lingkup kredensial, yang merupakan string yang menyertakan access key Anda, tanggal, wilayah yang Anda targetkan, layanan yang Anda minta, dan string penghentian ("aws4\$1request"). Nilai dinyatakan dalam format berikut: *access\$1key*/*HHBBTTTT*/*wilayah*/*layanan*/aws4\$1request.  
Untuk informasi selengkapnya, lihat [Membuat permintaan AWS API yang ditandatangani](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) di *Panduan Pengguna IAM*.  
Syarat: Tentukan parameter ini ketika Anda menyertakan informasi autentikasi dalam string kueri alih-alih di header otorisasi HTTP.  
Tipe: string  
Wajib: Bersyarat

 **X-Amz-Date**   <a name="CommonParameters-X-Amz-Date"></a>
Tanggal yang digunakan untuk membuat tanda tangan. Format harus berupa format dasar ISO 8601 (YYYYMMDD'T'HMMSS'Z'). Misalnya, waktu tanggal berikut adalah X-Amz-Date nilai yang valid:`20120325T120000Z`.  
Syarat: X-Amz-Date bersifat opsional untuk semua permintaan; ini dapat digunakan untuk menimpa tanggal yang digunakan untuk menandatangani permintaan. Jika header Tanggal ditentukan dalam format dasar ISO 8601, tidak X-Amz-Date diperlukan. Ketika X-Amz-Date digunakan, itu selalu mengesampingkan nilai header Tanggal. Untuk informasi selengkapnya, lihat [Elemen tanda tangan permintaan AWS API](https://docs.aws.amazon.com/IAM/latest/UserGuide/signing-elements.html) di *Panduan Pengguna IAM*.  
Jenis: string  
Wajib: Bersyarat

 **X-Amz-Security-Token**   <a name="CommonParameters-X-Amz-Security-Token"></a>
Token keamanan sementara yang diperoleh melalui panggilan ke AWS Security Token Service (AWS STS). Untuk daftar layanan yang mendukung kredensi keamanan sementara AWS STS, lihat layanan [Layanan AWS yang berfungsi dengan IAM di Panduan Pengguna *IAM*](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html).  
Kondisi: Jika Anda menggunakan kredensi keamanan sementara dari AWS STS, Anda harus menyertakan token keamanan.  
Jenis: string  
Wajib: Bersyarat

 **X-Amz-Signature**   <a name="CommonParameters-X-Amz-Signature"></a>
Menentukan tanda tangan yang dikodekan oleh hex yang dihitung dari string to sign dan kunci penandatanganan turunan.  
Syarat: Tentukan parameter ini ketika Anda menyertakan informasi autentikasi dalam string kueri alih-alih di header otorisasi HTTP.  
Tipe: string  
Wajib: Bersyarat

 **X-Amz-SignedHeaders**   <a name="CommonParameters-X-Amz-SignedHeaders"></a>
Menentukan semua header HTTP yang disertakan sebagai bagian dari permintaan kanonik. Untuk informasi selengkapnya tentang menentukan header yang ditandatangani, lihat [Membuat permintaan AWS API yang ditandatangani](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) di Panduan Pengguna *IAM*.  
Syarat: Tentukan parameter ini ketika Anda menyertakan informasi autentikasi dalam string kueri alih-alih di header otorisasi HTTP.  
Tipe: string  
Diperlukan: Kondisional