Gemini Voices API

Opsional. Apakah suara yang dibuat disimpan dan dikelola oleh Google. * Jika `true`, Google menyimpan suara dan menampilkan `Voice.id` (misalnya, `voice_abc123def456`), yang dapat dikelola melalui `GetVoice`, `ListVoices`, dan `DeleteVoice` serta dirujuk berdasarkan ID dalam permintaan sintesis. Suara yang disimpan akan berakhir setelah 1 tahun tidak aktif; menggunakan suara yang disimpan dalam sintesis ucapan atau sebagai `base_voice` di `CreateVoice` akan memperpanjang `expire_time`. Project tunduk pada kuota suara yang disimpan aktif maksimum; jika kuota terlampaui, `RESOURCE_EXHAUSTED` akan ditampilkan. * Jika `false` (default), suara tidak disimpan oleh Google dan `Voice.key` (misalnya, `voicekey_...`) akan ditampilkan untuk penyimpanan dan sintesis sisi klien. Kolom metadata penemuan opsional di `voice` tidak dipertahankan atau ditampilkan saat `store` adalah `false`. * Harus `true` saat `voice.type` adalah `"prompted"` (jika tidak, akan gagal dengan `INVALID_ARGUMENT`).

Wajib. Suara yang akan dibuat. `voice.model` bersifat opsional; jika tidak disertakan, layanan akan memilih model pembuatan suara default. Kolom hanya baca di `Voice` (`id`, `key`, `expire_time`, `usage`) diabaikan jika ditetapkan.

Opsional. Deskriptor aksen regional (misalnya, "Amerika", "Inggris").

Opsional. Konteks atau domain penggunaan yang optimal (misalnya, "Percakapan", "Buku audio", "Berita").

Opsional. Ringkasan deskriptif tentang timbre vokal, kepribadian, dan intonasi.

Opsional. Nama tampilan yang diberikan pengguna untuk suara tersimpan (`store = true`), atau nama katalog untuk suara bawaan.

Hanya output. Stempel waktu saat suara tersimpan kustom (`store = true`) atau kunci suara yang direplikasi (`store = false`) berakhir. Untuk suara tersimpan kustom (`store = true`), waktu habis masa berlaku ini diperpanjang saat suara digunakan untuk sintesis ucapan atau sebagai `base_voice` di `CreateVoice`. Tidak disetel untuk suara katalog bawaan (`"prebuilt"`), yang tidak memiliki masa berlaku.

Opsional. Persepsi presentasi gender suara (misalnya, "perempuan", "laki-laki", "netral").

Hanya output. ID unik suara. * Untuk suara kustom yang dikelola Google (`store = true`), ini adalah ID yang dibuat dengan awalan `voice_` (misalnya, `voice_abc123def456`). Teruskan `voices/{id}` sebagai `name` di `GetVoice` dan `DeleteVoice`, lalu teruskan `{id}` langsung ke `SpeechConfig.voice_config.voice` (atau `SpeechConfig.voice`) selama sintesis ucapan. * Untuk suara katalog bawaan (`"prebuilt"` yang ditampilkan oleh `ListVoices`), ini adalah nama penutur (misalnya, `Puck` atau `Charon`). * Tidak disetel saat `CreateVoice` dipanggil dengan `store = false`.

Hanya output. Kunci replikasi suara yang dikelola klien (dengan awalan `voicekey_`). Hanya ditampilkan oleh `CreateVoice` saat `type` adalah `"replicated"` dan `store` adalah `false`. Teruskan kunci ini ke `SpeechConfig.voice_config.voice` (atau `SpeechConfig.voice`) selama sintesis ucapan.

Opsional. Tag bahasa BCP-47 utama (misalnya, "en-US", "fr-FR").

Opsional. Model yang digunakan untuk mendesain atau mereplikasi suara. Jika tidak disertakan dalam `CreateVoice`, defaultnya adalah model desain suara yang didukung terbaru. Ditampilkan dalam respons `CreateVoice`, `GetVoice`, dan `ListVoices` untuk suara kustom (`"prompted"` dan `"replicated"`); tidak ditetapkan untuk suara `"prebuilt"`. Suara yang dibuat dapat disintesis di seluruh model sintesis TTS yang didukung.

Opsional. Persona atau arketipe karakter yang diinginkan (misalnya, "Hangat, Ramah", "Narator").

Opsional. Kode wilayah geografis ISO 3166-1 alpha-2 atau UN M.49 (misalnya, "US", "GB", "001").

Opsional. Filter menurut deskripsi aksen (misalnya, "Amerika", "Inggris"). Pencocokan persis yang tidak peka huruf besar/kecil. Jika beberapa nilai ditentukan, cocokkan suara dengan aksen yang ditentukan (OR).

Opsional. Filter menurut konteks atau domain yang dimaksud (misalnya, "Berita, Komersial"). Pencocokan persis yang tidak peka huruf besar/kecil. Jika beberapa nilai ditentukan, suara yang cocok adalah suara dengan salah satu konteks yang ditentukan (OR).

Opsional. Filter menurut presentasi gender (misalnya, "perempuan", "laki-laki", "netral"). Pencocokan persis yang tidak peka huruf besar/kecil. Jika beberapa nilai ditentukan, cocokkan suara dengan salah satu gender yang ditentukan (OR).

Opsional. Memfilter menurut kode bahasa BCP-47 (misalnya, "en-US"). Pencocokan persis yang tidak peka huruf besar/kecil. Jika beberapa nilai ditentukan, suara akan dicocokkan dengan salah satu kode bahasa yang ditentukan (OR).

Opsional. Jumlah maksimum suara yang akan ditampilkan per halaman. Layanan mungkin menampilkan lebih sedikit dari nilai ini. Jika tidak ditentukan, paling banyak 50 suara akan ditampilkan. Nilai maksimum adalah 1.000; nilai di atas 1.000 akan dikonversi menjadi 1.000.

Opsional. Token halaman yang diterima dari panggilan `ListVoices` sebelumnya. Berikan ini untuk mengambil halaman berikutnya. Saat melakukan penomoran halaman, semua parameter kueri filter (`language_code`, `region_code`, `accent`, `persona`, `context`, `gender`, `pitch`, `type`, dan `search`) harus cocok dengan panggilan yang menampilkan token ini; jika tidak, permintaan akan gagal dengan `INVALID_ARGUMENT`. `page_size` dapat berubah di antara halaman.

Opsional. Filter menurut persona suara (misalnya, "Hangat, Ramah"). Pencocokan persis yang tidak peka huruf besar/kecil. Jika beberapa nilai ditentukan, cocokkan suara dengan salah satu persona yang ditentukan (OR).

Opsional. Filter menurut nada suara. Menerima `"low"`, `"medium"`, `"high"` (tidak peka huruf besar/kecil). Jika beberapa nilai ditentukan, cocokkan suara dengan salah satu nada yang ditentukan (OR).

Opsional. Memfilter menurut kode wilayah ISO 3166-1 alpha-2 atau UN M.49 (misalnya, "US", "001"). Pencocokan persis yang tidak peka huruf besar/kecil. Jika beberapa nilai ditentukan, suara yang cocok adalah suara dengan salah satu kode wilayah yang ditentukan (OR).

Opsional. Kueri penelusuran substring teks bebas cocok dengan `display_name` dan `description` tanpa membedakan huruf besar/kecil. Maksimum 2.048 byte.

Opsional. Filter menurut jenis suara. Menerima `"prebuilt"`, `"replicated"`, `"prompted"` (tidak peka huruf besar/kecil). Jika beberapa nilai ditentukan, cocokkan suara dengan salah satu jenis yang ditentukan (OR).

Token yang dapat dikirim sebagai `page_token` untuk mengambil halaman berikutnya. Jika kosong, tidak akan ada halaman berikutnya.

Suara dari koleksi yang ditentukan.

Wajib. Nama resource suara tersimpan kustom yang akan diambil (misalnya, `voices/voice_abc123def456`).

Opsional. Deskriptor aksen regional (misalnya, "Amerika", "Inggris").

Opsional. Konteks atau domain penggunaan yang optimal (misalnya, "Percakapan", "Buku audio", "Berita").

Opsional. Ringkasan deskriptif tentang timbre vokal, kepribadian, dan intonasi.

Opsional. Nama tampilan yang diberikan pengguna untuk suara tersimpan (`store = true`), atau nama katalog untuk suara bawaan.

Hanya output. Stempel waktu saat suara tersimpan kustom (`store = true`) atau kunci suara yang direplikasi (`store = false`) berakhir. Untuk suara tersimpan kustom (`store = true`), waktu habis masa berlaku ini diperpanjang saat suara digunakan untuk sintesis ucapan atau sebagai `base_voice` di `CreateVoice`. Tidak disetel untuk suara katalog bawaan (`"prebuilt"`), yang tidak memiliki masa berlaku.

Opsional. Persepsi presentasi gender suara (misalnya, "perempuan", "laki-laki", "netral").

Hanya output. ID unik suara. * Untuk suara kustom yang dikelola Google (`store = true`), ini adalah ID yang dibuat dengan awalan `voice_` (misalnya, `voice_abc123def456`). Teruskan `voices/{id}` sebagai `name` di `GetVoice` dan `DeleteVoice`, lalu teruskan `{id}` langsung ke `SpeechConfig.voice_config.voice` (atau `SpeechConfig.voice`) selama sintesis ucapan. * Untuk suara katalog bawaan (`"prebuilt"` yang ditampilkan oleh `ListVoices`), ini adalah nama penutur (misalnya, `Puck` atau `Charon`). * Tidak disetel saat `CreateVoice` dipanggil dengan `store = false`.

Hanya output. Kunci replikasi suara yang dikelola klien (dengan awalan `voicekey_`). Hanya ditampilkan oleh `CreateVoice` saat `type` adalah `"replicated"` dan `store` adalah `false`. Teruskan kunci ini ke `SpeechConfig.voice_config.voice` (atau `SpeechConfig.voice`) selama sintesis ucapan.

Opsional. Tag bahasa BCP-47 utama (misalnya, "en-US", "fr-FR").

Opsional. Model yang digunakan untuk mendesain atau mereplikasi suara. Jika tidak disertakan dalam `CreateVoice`, defaultnya adalah model desain suara yang didukung terbaru. Ditampilkan dalam respons `CreateVoice`, `GetVoice`, dan `ListVoices` untuk suara kustom (`"prompted"` dan `"replicated"`); tidak ditetapkan untuk suara `"prebuilt"`. Suara yang dibuat dapat disintesis di seluruh model sintesis TTS yang didukung.

Opsional. Persona atau arketipe karakter yang diinginkan (misalnya, "Hangat, Ramah", "Narator").

Opsional. Kode wilayah geografis ISO 3166-1 alpha-2 atau UN M.49 (misalnya, "US", "GB", "001").

Wajib. Nama resource suara tersimpan kustom yang akan dihapus (misalnya, `voices/voice_abc123def456`).