Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
StartSpeechSynthesisStream
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
Minta Sintaks
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
Permintaan menggunakan parameter URI berikut.
- Engine
-
Menentukan mesin untuk Amazon Polly untuk digunakan saat memproses teks input untuk sintesis ucapan. Saat ini, hanya
generativemesin yang didukung. Jika Anda menentukan suara yang tidak didukung oleh mesin yang dipilih, Amazon Polly menampilkan kesalahan.Nilai yang Valid:
standard | neural | long-form | generativeWajib: Ya
- LanguageCode
-
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
-
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
-
Format audio untuk pidato yang disintesis. Saat ini, Amazon Polly tidak mendukung tanda bicara JSON.
Nilai yang Valid:
json | mp3 | ogg_opus | ogg_vorbis | pcmWajib: Ya
- SampleRate
-
Frekuensi audio, ditentukan dalam Hz.
- VoiceId
-
Suara untuk digunakan dalam sintesis. Untuk mendapatkan daftar suara yang tersedia IDs, gunakan DescribeVoicesoperasi.
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 | TiffanyWajib: Ya
Isi Permintaan
Permintaan menerima data berikut dalam format JSON.
- CloseStreamEvent
-
Peristiwa yang menunjukkan akhir aliran input.
Tipe: Objek CloseStreamEvent
Wajib: Tidak
- TextEvent
-
Sebuah peristiwa teks yang berisi konten yang akan disintesis.
Tipe: Objek TextEvent
Wajib: Tidak
Sintaksis Respons
HTTP/1.1 200
Content-type: application/json
{
"AudioEvent": {
"AudioChunk": blob
},
"ServiceFailureException": {
},
"ServiceQuotaExceededException": {
},
"StreamClosedEvent": {
"RequestCharacters": number
},
"ThrottlingException": {
},
"ValidationException": {
}
}
Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
- AudioEvent
-
Acara audio yang berisi pidato yang disintesis.
Tipe: Objek AudioEvent
- ServiceFailureException
-
Kondisi yang tidak diketahui telah menyebabkan kegagalan layanan.
Jenis: Pengecualian
Kode Status HTTP: 500
- ServiceQuotaExceededException
-
Pengecualian yang menunjukkan kuota layanan akan terlampaui.
Jenis: Pengecualian
Kode Status HTTP: 402
- StreamClosedEvent
-
Sebuah peristiwa, dengan informasi ringkasan, yang menunjukkan aliran telah ditutup.
Tipe: Objek StreamClosedEvent
- ThrottlingException
-
Pengecualian yang menunjukkan permintaan dibatasi.
Jenis: Pengecualian
Kode Status HTTP: 400
- ValidationException
-
Pengecualian yang menunjukkan validasi input gagal.
Jenis: Pengecualian
Kode Status HTTP: 400
Kesalahan
- 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
Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini: