Gemini Voices API

İsteğe bağlıdır. Oluşturulan sesin Google tarafından saklanıp yönetilip yönetilmediği * "Doğru" olduğunda Google, sesi saklar ve `GetVoice`, `ListVoices` ve `DeleteVoice` üzerinden yönetilebilen ve sentez isteklerinde kimliğe göre referans verilen `Voice.id` değerini (ör. `voice_abc123def456`) döndürür. Depolanan seslerin geçerlilik süresi, 1 yıl boyunca kullanılmadığında sona erer. Depolanan bir sesin konuşma sentezinde kullanılması veya `CreateVoice` içinde `base_voice` olarak kullanılması, `expire_time` değerini uzatır. Projeler, depolanan seslerin maksimum etkin kotasına tabidir. Kotanın aşılması durumunda `RESOURCE_EXHAUSTED` hatası döndürülür. * `false` (varsayılan) olduğunda ses, Google tarafından depolanmaz ve istemci tarafında depolama ve sentez için `Voice.key` (örneğin, `voicekey_...`) döndürülür. `voice` üzerindeki isteğe bağlı keşif meta verileri alanları, `store` değeri `false` olduğunda kalıcı hale getirilmez veya döndürülmez. * `voice.type` değeri `"prompted"` olduğunda `true` olması gerekir (aksi takdirde `INVALID_ARGUMENT` ile başarısız olur).

Zorunlu. Oluşturmak için kullanılacak ses. `voice.model` isteğe bağlıdır. Atlanırsa hizmet, varsayılan ses oluşturma modelini seçer. "Voice" üzerindeki yalnızca çıkış alanları ("id", "key", "expire_time", "usage") ayarlanırsa yoksayılır.

İsteğe bağlıdır. Bölgesel aksan tanımlayıcısı (ör. "Amerikan", "İngiliz").

İsteğe bağlıdır. En uygun kullanım bağlamı veya alan (ör. "Sohbet", "Sesli Kitap", "Haber").

İsteğe bağlıdır. Vokal tını, kişilik ve tonun açıklayıcı özeti.

İsteğe bağlıdır. Kayıtlı bir ses için kullanıcı tarafından sağlanan görünen ad (`store = true`) veya önceden oluşturulmuş bir ses için katalog adı.

Yalnızca çıkış. Özel olarak saklanan bir sesin (`store = true`) veya kopyalanan bir ses anahtarının (`store = false`) geçerliliğinin sona erdiği zaman damgası. Özel olarak saklanan sesler (`store = true`) için bu geçerlilik süresi, ses konuşma sentezi için veya `CreateVoice` içinde `base_voice` olarak kullanıldığında uzatılır. Önceden oluşturulmuş katalog sesleri (`"prebuilt"`) için geçerlilik süresi dolmaz.

İsteğe bağlıdır. Algılanan ses cinsiyeti sunumu (ör. "kadın", "erkek", "nötr").

Yalnızca çıkış. Sesin benzersiz tanımlayıcısı. * Google tarafından yönetilen özel sesler (`store = true`) için bu, `voice_` önekiyle oluşturulan bir kimliktir (örneğin, `voice_abc123def456`). `GetVoice` ve `DeleteVoice` işlemlerinde `voices/{id}` değerini `name` olarak, konuşma sentezi sırasında ise `{id}` değerini doğrudan `SpeechConfig.voice_config.voice` (veya `SpeechConfig.voice`) olarak iletin. * Önceden oluşturulmuş katalog sesleri (`ListVoices` tarafından döndürülen `"prebuilt"`) için bu, konuşmacı adıdır (ör. `Puck` veya `Charon`). * `CreateVoice`, `store = false` ile çağrıldığında ayarlanmaz.

Yalnızca çıkış. İstemci tarafından yönetilen ses kopyalama anahtarı (ön ekli `voicekey_`). Yalnızca `type` değeri `"replicated"` ve `store` değeri `false` olduğunda `CreateVoice` tarafından döndürülür. Bu anahtarı konuşma sentezi sırasında `SpeechConfig.voice_config.voice` (veya `SpeechConfig.voice`) öğesine iletin.

İsteğe bağlıdır. Birincil BCP-47 dil etiketi (ör. "en-US", "fr-FR").

İsteğe bağlıdır. Sesi tasarlamak veya kopyalamak için kullanılan model. `CreateVoice` içinde atlanırsa varsayılan olarak desteklenen en yeni ses tasarımı modeli kullanılır. Özel sesler (`"prompted"` ve `"replicated"`) için `CreateVoice`, `GetVoice` ve `ListVoices` yanıtlarında döndürülür; `"prebuilt"` sesler için ayarlanmamıştır. Oluşturulan sesler, desteklenen tüm TTS sentez modellerinde sentezlenebilir.

İsteğe bağlıdır. Hedeflenen karakter veya karakter arketipi (ör. "Sıcakkanlı, Arkadaş Canlısı", "Anlatıcı").

İsteğe bağlıdır. ISO 3166-1 alfa-2 veya UN M.49 coğrafi bölge kodu (ör. "US", "GB", "001").

İsteğe bağlıdır. Aksan açıklamasına göre filtreleyin (ör. "Amerikan", "İngiliz"). Büyük/küçük harfe duyarlı olmayan tam eşleşme. Birden fazla değer belirtilirse belirtilen aksanlardan herhangi birine (VEYA) sahip seslerle eşleşir.

İsteğe bağlıdır. Amaçlanan bağlama veya alana göre filtreleyin (ör. "Haber, Ticari"). Büyük/küçük harfe duyarlı olmayan tam eşleşme. Birden fazla değer belirtilirse belirtilen bağlamlardan herhangi biriyle (VEYA) eşleşen sesler.

İsteğe bağlıdır. Cinsiyet sunumuna göre filtreleyin (ör. "kadın", "erkek", "nötr"). Büyük/küçük harfe duyarlı olmayan tam eşleşme. Birden fazla değer belirtilirse belirtilen cinsiyetlerden herhangi birine (OR) sahip seslerle eşleşir.

İsteğe bağlıdır. BCP-47 dil koduna göre filtreleyin (ör. "en-US"). Büyük/küçük harfe duyarlı olmayan tam eşleşme. Birden fazla değer belirtilirse belirtilen dil kodlarından herhangi biriyle (VEYA) eşleşen sesler kullanılır.

İsteğe bağlıdır. Sayfa başına döndürülecek maksimum ses sayısı. Hizmet, bu değerden daha az sonuç döndürebilir. Belirtilmezse en fazla 50 ses döndürülür. Maksimum değer 1.000'dir. 1.000'den yüksek değerler 1.000'e zorlanır.

İsteğe bağlıdır. Önceki bir "ListVoices" çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın. Sayfalama yapılırken tüm filtre sorgusu parametreleri (`language_code`, `region_code`, `accent`, `persona`, `context`, `gender`, `pitch`, `type` ve `search`) bu jetonu döndüren çağrıyla eşleşmelidir. Aksi takdirde istek, `INVALID_ARGUMENT` ile başarısız olur. `page_size` sayfalar arasında değişebilir.

İsteğe bağlıdır. Vokal karakterine göre filtreleyin (ör. "Sıcak, Samimi"). Büyük/küçük harfe duyarlı olmayan tam eşleşme. Birden fazla değer belirtilirse sesler, belirtilen karakterlerden herhangi biriyle (VEYA) eşleşir.

İsteğe bağlıdır. Vokal perdesine göre filtreleme yapın. `"low"`, `"medium"`, `"high"` değerlerini kabul eder (büyük/küçük harfe duyarsız). Birden fazla değer belirtilirse sesler, belirtilen tonlardan herhangi biriyle (VEYA) eşleşir.

İsteğe bağlıdır. ISO 3166-1 alfa-2 veya UN M.49 bölge koduna göre filtreleyin (ör. "US", "001"). Büyük/küçük harfe duyarlı olmayan tam eşleşme. Birden fazla değer belirtilirse belirtilen bölge kodlarından herhangi biriyle (VEYA) eşleşen sesler.

İsteğe bağlıdır. Serbest metin alt dizesi arama sorgusu, hem "display_name" hem de "description" ile büyük/küçük harfe duyarsız şekilde eşleştirildi. Maksimum 2.048 bayt.

İsteğe bağlıdır. Ses türüne göre filtreleyin. `"prebuilt"`, `"replicated"`, `"prompted"` değerlerini kabul eder (büyük/küçük harfe duyarsız). Birden fazla değer belirtilirse faturaları belirtilen türlerden herhangi biriyle eşleştirir (VEYA).

Bir sonraki sayfayı almak için "page_token" olarak gönderilebilen jeton. Boşsa sonraki sayfa yoktur.

Belirtilen koleksiyondaki sesler.

Zorunlu. Alınacak özel kayıtlı sesin kaynak adı (örneğin, "voices/voice_abc123def456").

İsteğe bağlıdır. Bölgesel aksan tanımlayıcısı (ör. "Amerikan", "İngiliz").

İsteğe bağlıdır. En uygun kullanım bağlamı veya alan (ör. "Sohbet", "Sesli Kitap", "Haber").

İsteğe bağlıdır. Vokal tını, kişilik ve tonun açıklayıcı özeti.

İsteğe bağlıdır. Kayıtlı bir ses için kullanıcı tarafından sağlanan görünen ad (`store = true`) veya önceden oluşturulmuş bir ses için katalog adı.

Yalnızca çıkış. Özel olarak saklanan bir sesin (`store = true`) veya kopyalanan bir ses anahtarının (`store = false`) geçerliliğinin sona erdiği zaman damgası. Özel olarak saklanan sesler (`store = true`) için bu geçerlilik süresi, ses konuşma sentezi için veya `CreateVoice` içinde `base_voice` olarak kullanıldığında uzatılır. Önceden oluşturulmuş katalog sesleri (`"prebuilt"`) için geçerlilik süresi dolmaz.

İsteğe bağlıdır. Algılanan ses cinsiyeti sunumu (ör. "kadın", "erkek", "nötr").

Yalnızca çıkış. Sesin benzersiz tanımlayıcısı. * Google tarafından yönetilen özel sesler (`store = true`) için bu, `voice_` önekiyle oluşturulan bir kimliktir (örneğin, `voice_abc123def456`). `GetVoice` ve `DeleteVoice` işlemlerinde `voices/{id}` değerini `name` olarak, konuşma sentezi sırasında ise `{id}` değerini doğrudan `SpeechConfig.voice_config.voice` (veya `SpeechConfig.voice`) olarak iletin. * Önceden oluşturulmuş katalog sesleri (`ListVoices` tarafından döndürülen `"prebuilt"`) için bu, konuşmacı adıdır (ör. `Puck` veya `Charon`). * `CreateVoice`, `store = false` ile çağrıldığında ayarlanmaz.

Yalnızca çıkış. İstemci tarafından yönetilen ses kopyalama anahtarı (ön ekli `voicekey_`). Yalnızca `type` değeri `"replicated"` ve `store` değeri `false` olduğunda `CreateVoice` tarafından döndürülür. Bu anahtarı konuşma sentezi sırasında `SpeechConfig.voice_config.voice` (veya `SpeechConfig.voice`) öğesine iletin.

İsteğe bağlıdır. Birincil BCP-47 dil etiketi (ör. "en-US", "fr-FR").

İsteğe bağlıdır. Sesi tasarlamak veya kopyalamak için kullanılan model. `CreateVoice` içinde atlanırsa varsayılan olarak desteklenen en yeni ses tasarımı modeli kullanılır. Özel sesler (`"prompted"` ve `"replicated"`) için `CreateVoice`, `GetVoice` ve `ListVoices` yanıtlarında döndürülür; `"prebuilt"` sesler için ayarlanmamıştır. Oluşturulan sesler, desteklenen tüm TTS sentez modellerinde sentezlenebilir.

İsteğe bağlıdır. Hedeflenen karakter veya karakter arketipi (ör. "Sıcakkanlı, Arkadaş Canlısı", "Anlatıcı").

İsteğe bağlıdır. ISO 3166-1 alfa-2 veya UN M.49 coğrafi bölge kodu (ör. "US", "GB", "001").

Zorunlu. Silinecek özel kayıtlı sesin kaynak adı (ör. "voices/voice_abc123def456").