StartSpeechSynthesisStream - Amazon Polly

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

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 | pcm

Wajib: 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 | Tiffany

Wajib: 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: