Gemini Voices API

Opsionale. Nëse zëri i krijuar ruhet dhe menaxhohet nga Google. * Kur është `true`, Google ruan zërin dhe kthen `Voice.id` (për shembull, `voice_abc123def456`), i cili mund të menaxhohet nëpërmjet `GetVoice`, `ListVoices` dhe `DeleteVoice` dhe referohet nga ID-ja në kërkesat e sintezës. Zërat e ruajtur skadojnë pas 1 viti joaktivitet; përdorimi i një zëri të ruajtur në sintezën e të folurit ose si `base_voice` në `CreateVoice` zgjat `expire_time`. Projektet janë objekt i një kuote maksimale të zërit të ruajtur aktiv; tejkalimi i kuotës kthen `RESOURCE_EXHAUSTED`. * Kur është `false` (parazgjedhja), zëri nuk ruhet nga Google dhe `Voice.key` (p.sh. `voicekey_...`) kthehet për ruajtjen dhe sintezën në anën e klientit. Fushat opsionale të metadatave të zbulimit në `voice` nuk ruhen ose nuk kthehen kur `store` është `false`. * Kërkohet që të jetë `true` kur `voice.type` është `"prompted"` (në rast të kundërt dështon me `INVALID_ARGUMENT`).

Kërkohet. Zëri për të krijuar. `voice.model` është opsional; nëse hiqet, shërbimi zgjedh modelin e parazgjedhur të krijimit të zërit. Fushat vetëm për dalje në `Voice` (`id`, `key`, `expire_time`, `usage`) shpërfillen nëse caktohen.

Opsionale. Përshkruesi i theksit rajonal (p.sh. "Amerikan", "Britanik").

Opsionale. Konteksti ose domeni optimal i përdorimit (p.sh. "Bisedor", "Libër audio", "Lajme").

Opsionale. Përmbledhje përshkruese e timbrit vokal, personalitetit dhe tonit.

Opsionale. Emri prezantues i dhënë nga përdoruesi për një zë të ruajtur (`store = true`), ose emri i katalogut për një zë të parakonstruksionuar.

Vetëm rezultat. Vula kohore në të cilën skadon një zë i personalizuar i ruajtur (`store = true`) ose një çelës zëri i replikuar (`store = false`). Për zërat e personalizuar të ruajtur (`store = true`), kjo kohë skadimi zgjatet kur zëri përdoret për sintezën e ligjërimit ose si një `base_voice` në `CreateVoice`. Anulo caktimin për zërat e katalogut të parakonstruksionit (`"prebuilt"`), të cilët nuk skadojnë.

Opsionale. Prezantimi i gjinisë së perceptuar të zërit (p.sh. "femër", "mashkull", "neutrale").

Vetëm rezultat. Identifikuesi unik i zërit. * Për zërat e personalizuar të menaxhuar nga Google (`store = true`), kjo është një ID e gjeneruar me parashtesën `voice_` (p.sh. `voice_abc123def456`). Transmeto `voices/{id}` si `name` në `GetVoice` dhe `DeleteVoice` dhe transmeto `{id}` drejtpërdrejt te `SpeechConfig.voice_config.voice` (ose `SpeechConfig.voice`) gjatë sintezës së të folurit. * Për zërat e katalogut të parakonstruksionit (`"prebuilt"` të kthyer nga `ListVoices`), ky është emri i altoparlantit (për shembull, `Puck` ose `Charon`). * I pacaktuar kur `CreateVoice` thirret me `store = false`.

Vetëm rezultat. Çelësi i replikimit të zërit të menaxhuar nga klienti (me parashtesën `voicekey_`). Kthehet vetëm nga `CreateVoice` kur `type` është `"replicated"` dhe `store` është `false`. Kaloji këtë çelës te `SpeechConfig.voice_config.voice` (ose `SpeechConfig.voice`) gjatë sintezës së të folurit.

Opsionale. Etiketa e gjuhës kryesore BCP-47 (p.sh. "en-US", "fr-FR").

Opsionale. Modeli i përdorur për të projektuar ose replikuar zërin. Nëse hiqet në `CreateVoice`, parazgjedhja është modeli më i fundit i mbështetur i dizajnit të zërit. Kthehet në përgjigjet e `CreateVoice`, `GetVoice` dhe `ListVoices` për zërat e personalizuar (`"prompted"` dhe `"replicated"`); nuk është caktuar për zërat `"prebuilt"`. Zërat e krijuar mund të sintetizohen në çdo model të mbështetur të sintezës TTS.

Opsionale. Personazhi i synuar ose arketipi i personazhit (p.sh. "I ngrohtë, miqësor", "Narrator").

Opsionale. Kodi i rajonit gjeografik ISO 3166-1 alpha-2 ose UN M.49 (p.sh. "US", "GB", "001").

Opsionale. Filtro sipas përshkrimit të theksit (p.sh. "Amerikan", "Britanik"). Përputhje e saktë e pandjeshme ndaj shkronjave të mëdha dhe të vogla. Nëse specifikohen disa vlera, përputhet me zërat me cilindo nga theksat e specifikuara (OR).

Opsionale. Filtro sipas kontekstit ose domenit të synuar (p.sh. "Lajme, Reklamë"). Përputhje e saktë e pandjeshme ndaj shkronjave të mëdha dhe të vogla. Nëse specifikohen disa vlera, përputhet me zërat me cilindo nga kontekstet e specifikuara (OR).

Opsionale. Filtro sipas prezantimit të gjinisë (p.sh. "femër", "mashkull", "neutrale"). Përputhje e saktë e pandjeshme ndaj shkronjave të mëdha dhe të vogla. Nëse specifikohen disa vlera, përputhet me zërat me cilindo nga gjinitë e specifikuara (OR).

Opsionale. Filtro sipas kodit të gjuhës BCP-47 (p.sh. "en-US"). Përputhje e saktë e pandjeshme ndaj shkronjave të mëdha dhe të vogla. Nëse specifikohen disa vlera, përputhet me zërat me cilindo nga kodet e specifikuara të gjuhës (OR).

Opsionale. Numri maksimal i zërave për t'u kthyer për faqe. Shërbimi mund të kthejë më pak se kjo vlerë. Nëse nuk specifikohet, kthehen maksimumi 50 zëra. Vlera maksimale është 1000; vlerat mbi 1000 detyrohen të jenë 1000.

Opsionale. Një kod faqesh i marrë nga një thirrje e mëparshme e `ListVoices`. Jepi këtë për të marrë faqen pasardhëse. Kur faqëzon, të gjithë parametrat e kërkesës së filtrit (`language_code`, `region_code`, `accent`, `persona`, `context`, `gender`, `pitch`, `type`, dhe `search`) duhet të përputhen me thirrjen që ktheu këtë kod; përndryshe kërkesa dështon me `INVALID_ARGUMENT`. `page_size` mund të ndryshojë midis faqeve.

Opsionale. Filtro sipas personazhit vokal (p.sh. "I ngrohtë, miqësor"). Përputhje e saktë e pandjeshme ndaj shkronjave të mëdha dhe të vogla. Nëse specifikohen disa vlera, përputhet me zërat me cilindo nga personazhet e specifikuara (OR).

Opsionale. Filtro sipas tonit të vokalit. Pranon `"low"`, `"medium"`, `"high"` (pa dallim shkronjash të mëdha dhe të vogla). Nëse specifikohen disa vlera, përputh zërat me ndonjë nga tonalitetet e specifikuara (OR).

Opsionale. Filtro sipas kodit të rajonit ISO 3166-1 alpha-2 ose UN M.49 (p.sh. "US", "001"). Përputhje e saktë e pandjeshme ndaj shkronjave të mëdha dhe të vogla. Nëse specifikohen disa vlera, përputhet me zërat me cilindo nga kodet e specifikuara të rajoneve (OR).

Opsionale. Kërkesa e kërkimit për nënvargun e tekstit të lirë përputhet pa dallim shkronjash të mëdha dhe të vogla me `display_name` dhe `description`. Maksimumi 2048 bajt.

Opsionale. Filtro sipas llojit të zërit. Pranon `"të parandërtuara"`, `"të replikuara"`, `"të sugjeruara"` (pa dallim shkronjash të mëdha dhe të vogla). Nëse specifikohen disa vlera, përputhet me zërat me cilindo nga llojet e specifikuara (OR).

Një kod që mund të dërgohet si `page_token` për të marrë faqen tjetër. Nëse është bosh, nuk ka faqe të tjera pasuese.

Zërat nga koleksioni i specifikuar.

Kërkohet. Emri i burimit të zërit të personalizuar të ruajtur për ta marrë (për shembull, `voices/voice_abc123def456`).

Opsionale. Përshkruesi i theksit rajonal (p.sh. "Amerikan", "Britanik").

Opsionale. Konteksti ose domeni optimal i përdorimit (p.sh. "Bisedor", "Libër audio", "Lajme").

Opsionale. Përmbledhje përshkruese e timbrit vokal, personalitetit dhe tonit.

Opsionale. Emri prezantues i dhënë nga përdoruesi për një zë të ruajtur (`store = true`), ose emri i katalogut për një zë të parakonstruksionuar.

Vetëm rezultat. Vula kohore në të cilën skadon një zë i personalizuar i ruajtur (`store = true`) ose një çelës zëri i replikuar (`store = false`). Për zërat e personalizuar të ruajtur (`store = true`), kjo kohë skadimi zgjatet kur zëri përdoret për sintezën e ligjërimit ose si një `base_voice` në `CreateVoice`. Anulo caktimin për zërat e katalogut të parakonstruksionit (`"prebuilt"`), të cilët nuk skadojnë.

Opsionale. Prezantimi i gjinisë së perceptuar të zërit (p.sh. "femër", "mashkull", "neutrale").

Vetëm rezultat. Identifikuesi unik i zërit. * Për zërat e personalizuar të menaxhuar nga Google (`store = true`), kjo është një ID e gjeneruar me parashtesën `voice_` (p.sh. `voice_abc123def456`). Transmeto `voices/{id}` si `name` në `GetVoice` dhe `DeleteVoice` dhe transmeto `{id}` drejtpërdrejt te `SpeechConfig.voice_config.voice` (ose `SpeechConfig.voice`) gjatë sintezës së të folurit. * Për zërat e katalogut të parakonstruksionit (`"prebuilt"` të kthyer nga `ListVoices`), ky është emri i altoparlantit (për shembull, `Puck` ose `Charon`). * I pacaktuar kur `CreateVoice` thirret me `store = false`.

Vetëm rezultat. Çelësi i replikimit të zërit të menaxhuar nga klienti (me parashtesën `voicekey_`). Kthehet vetëm nga `CreateVoice` kur `type` është `"replicated"` dhe `store` është `false`. Kaloji këtë çelës te `SpeechConfig.voice_config.voice` (ose `SpeechConfig.voice`) gjatë sintezës së të folurit.

Opsionale. Etiketa e gjuhës kryesore BCP-47 (p.sh. "en-US", "fr-FR").

Opsionale. Modeli i përdorur për të projektuar ose replikuar zërin. Nëse hiqet në `CreateVoice`, parazgjedhja është modeli më i fundit i mbështetur i dizajnit të zërit. Kthehet në përgjigjet e `CreateVoice`, `GetVoice` dhe `ListVoices` për zërat e personalizuar (`"prompted"` dhe `"replicated"`); nuk është caktuar për zërat `"prebuilt"`. Zërat e krijuar mund të sintetizohen në çdo model të mbështetur të sintezës TTS.

Opsionale. Personazhi i synuar ose arketipi i personazhit (p.sh. "I ngrohtë, miqësor", "Narrator").

Opsionale. Kodi i rajonit gjeografik ISO 3166-1 alpha-2 ose UN M.49 (p.sh. "US", "GB", "001").

Kërkohet. Emri i burimit të zërit të personalizuar të ruajtur për ta fshirë (për shembull, `voices/voice_abc123def456`).