Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
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 menentukanen-US, operasi mengembalikan daftar semua suara bahasa Inggris AS yang tersedia.
Operasi ini memerlukan izin untuk menjalankan tindakan polly:DescribeVoices.
Minta Sintaks
GET /v1/voices?Engine=Engine&IncludeAdditionalLanguageCodes=IncludeAdditionalLanguageCodes&LanguageCode=LanguageCode&NextToken=NextToken HTTP/1.1
Parameter Permintaan URI
Permintaan menggunakan parameter URI berikut.
- Engine
-
Menentukan mesin (
standard,neural,long-formataugenerative) yang digunakan oleh Amazon Polly saat memproses teks input untuk sintesis ucapan.Nilai Valid:
standard | neural | long-form | generative - IncludeAdditionalLanguageCodes
-
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
yestetapi tidak jika Anda menentukan.no - LanguageCode
-
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 - NextToken
-
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
Permintaan tidak memiliki isi permintaan.
Sintaks Respons
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
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
Kesalahan
- 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
Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
