Gemini Voices API

Voices API की मदद से, नैचुरल लैंग्वेज प्रॉम्प्ट (वॉइस डिज़ाइन) या रेफ़रंस ऑडियो और स्पीकर की सहमति वाली रिकॉर्डिंग (वॉइस रेप्लिकेशन) से कस्टम आवाज़ें बनाई जा सकती हैं. साथ ही, लिखाई को बोली में बदलने (टीटीएस) की सुविधा के लिए, कस्टम और पहले से बनी आवाज़ों को सूची में शामिल किया जा सकता है, उन्हें वापस पाया जा सकता है, और मैनेज किया जा सकता है.

मार्कडाउन के तौर पर देखें OpenAPI स्पेसिफ़िकेशन देखें

CreateVoice

post https://generativelanguage.googleapis.com/v1beta/voices

यह फ़ंक्शन, नैचुरल लैंग्वेज वाले प्रॉम्प्ट (`VOICE_TYPE_PROMPTED`) या रेफ़रंस और सहमति वाली ऑडियो रिकॉर्डिंग (`VOICE_TYPE_REPLICATED`) से कस्टम आवाज़ बनाता है.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल होता है:

store boolean  (ज़रूरी नहीं)

ज़रूरी नहीं. इससे पता चलता है कि बनाई गई आवाज़ को Google सेव करके रखता है या नहीं. * `true` होने पर, Google आवाज़ को सेव करता है और `Voice.id` दिखाता है. उदाहरण के लिए, `voice_abc123def456`. इसे `GetVoice`, `ListVoices`, और `DeleteVoice` के ज़रिए मैनेज किया जा सकता है. साथ ही, सिंथेसिस के अनुरोधों में आईडी के हिसाब से इसका रेफ़रंस दिया जा सकता है. स्टोर की गई आवाज़ों का इस्तेमाल न करने पर, वे एक साल बाद मिट जाती हैं. स्पीच सिंथेसिस में स्टोर की गई आवाज़ का इस्तेमाल करने या `CreateVoice` में `base_voice` के तौर पर इस्तेमाल करने से, इसके `expire_time` की अवधि बढ़ जाती है. प्रोजेक्ट में, स्टोर की गई आवाज़ों के लिए ज़्यादा से ज़्यादा कोटा तय किया गया है. कोटा पूरा होने पर, `RESOURCE_EXHAUSTED` दिखता है. * जब `false` (डिफ़ॉल्ट) होता है, तो Google आवाज़ को स्टोर नहीं करता है. साथ ही, क्लाइंट-साइड स्टोरेज और सिंथेसिस के लिए `Voice.key` (उदाहरण के लिए, `voicekey_...`) दिखाता है. `voice` पर मौजूद खोज के लिए उपलब्ध मेटाडेटा फ़ील्ड को तब सेव नहीं किया जाता या वापस नहीं भेजा जाता, जब `store` की वैल्यू `false` होती है. * जब `voice.type` की वैल्यू `"prompted"` होती है, तब `store` की वैल्यू `true` होनी चाहिए. ऐसा न होने पर, `INVALID_ARGUMENT` गड़बड़ी दिखती है.

voice Voice  (ज़रूरी है)

ज़रूरी है. आवाज़ बनाने के लिए. `voice.model` पैरामीटर का इस्तेमाल करना ज़रूरी नहीं है. अगर इसे शामिल नहीं किया जाता है, तो सेवा आवाज़ बनाने के लिए डिफ़ॉल्ट मॉडल चुनती है. अगर `Voice` पर सिर्फ़ आउटपुट वाले फ़ील्ड (`id`, `key`, `expire_time`, `usage`) सेट किए जाते हैं, तो उन्हें अनदेखा कर दिया जाता है.

जवाब

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

accent string  (ज़रूरी नहीं)

ज़रूरी नहीं. क्षेत्रीय लहज़े के बारे में बताने वाला शब्द (जैसे, "अमेरिकन", "ब्रिटिश").

context string  (ज़रूरी नहीं)

ज़रूरी नहीं. इस्तेमाल का सबसे सही कॉन्टेक्स्ट या डोमेन (जैसे, "बातचीत", "ऑडियो बुक", "खबरें").

description string  (ज़रूरी नहीं)

ज़रूरी नहीं. आवाज़ की टोन, पर्सनैलिटी, और पिच के बारे में जानकारी देने वाली खास जानकारी.

display_name string  (ज़रूरी नहीं)

ज़रूरी नहीं. यह प्रॉपर्टी, सेव की गई आवाज़ (`store = true`) के लिए, उपयोगकर्ता के दिए गए डिसप्ले नेम के बारे में जानकारी देती है. इसके अलावा, यह पहले से मौजूद आवाज़ के लिए कैटलॉग नेम के बारे में भी जानकारी देती है.

expire_time string  (optional)

सिर्फ़ आउटपुट के लिए. वह टाइमस्टैंप जिस पर कस्टम तौर पर सेव की गई आवाज़ (`store = true`) या मिलती-जुलती आवाज़ की कुंजी (`store = false`) की समयसीमा खत्म हो जाती है. कस्टम तौर पर सेव की गई आवाज़ों (`store = true`) के लिए, इस समयसीमा को तब बढ़ा दिया जाता है, जब आवाज़ का इस्तेमाल स्पीच सिंथेसिस के लिए किया जाता है या `CreateVoice` में `base_voice` के तौर पर किया जाता है. पहले से मौजूद कैटलॉग की आवाज़ों (`"prebuilt"`) के लिए, इसे सेट नहीं किया जाता है. इनकी समयसीमा खत्म नहीं होती.

gender string  (ज़रूरी नहीं)

ज़रूरी नहीं. आवाज़ के लिंग की पहचान (जैसे, "महिला", "पुरुष", "तटस्थ").

id string  (ज़रूरी नहीं)

सिर्फ़ आउटपुट के लिए. आवाज़ का यूनीक आइडेंटिफ़ायर. * Google की ओर से मैनेज की जाने वाली कस्टम आवाज़ों (`store = true`) के लिए, यह जनरेट किया गया आईडी होता है. इसमें `voice_` प्रीफ़िक्स होता है. उदाहरण के लिए, `voice_abc123def456`. `GetVoice` और `DeleteVoice` में `name` के तौर पर `voices/{id}` पास करें. साथ ही, स्पीच सिंथेसिस के दौरान `SpeechConfig.voice_config.voice` (या `SpeechConfig.voice`) में सीधे तौर पर `{id}` पास करें. * पहले से मौजूद कैटलॉग की आवाज़ों (`ListVoices` से मिली `"prebuilt"`) के लिए, यह स्पीकर का नाम होता है. उदाहरण के लिए, `Puck` या `Charon`. * `CreateVoice` को `store = false` के साथ कॉल करने पर, इसे सेट नहीं किया जाता.

key string  (ज़रूरी नहीं)

सिर्फ़ आउटपुट के लिए. क्लाइंट के मैनेज की गई आवाज़ की नकल बनाने की कुंजी (प्रीफ़िक्स `voicekey_` के साथ). यह कुंजी सिर्फ़ `CreateVoice` फ़ंक्शन से तब मिलती है, जब `type` की वैल्यू `"replicated"` और `store` की वैल्यू `false` होती है. स्पीच सिंथेसिस के दौरान, इस कुंजी को `SpeechConfig.voice_config.voice` (या `SpeechConfig.voice`) को पास करें.

language_code string  (ज़रूरी नहीं)

ज़रूरी नहीं. BCP-47 का मुख्य भाषा टैग (जैसे, "en-US", "fr-FR").

model string  (ज़रूरी नहीं)

ज़रूरी नहीं. आवाज़ को डिज़ाइन करने या उसकी नकल करने के लिए इस्तेमाल किया गया मॉडल. अगर `CreateVoice` में इसे शामिल नहीं किया जाता है, तो यह डिफ़ॉल्ट रूप से, आवाज़ के डिज़ाइन वाले सबसे नए मॉडल पर सेट होता है. यह वैल्यू, `CreateVoice`, `GetVoice`, और `ListVoices` के जवाबों में मिलती है. यह वैल्यू, कस्टम आवाज़ों (`"prompted"` और `"replicated"`) के लिए सेट होती है. हालांकि, `"prebuilt"` आवाज़ों के लिए यह वैल्यू सेट नहीं होती. बनाई गई आवाज़ों को, टीटीएस के साथ काम करने वाले किसी भी सिंथेसिस मॉडल में इस्तेमाल किया जा सकता है.

persona string  (ज़रूरी नहीं)

ज़रूरी नहीं. इस्तेमाल किया जाने वाला पर्सोना या किरदार (जैसे, "मिलनसार", "नैरेटर").

पिच पिच  (ज़रूरी नहीं)

ज़रूरी नहीं. आवाज़ की पिच की कैटगरी.

संभावित वैल्यू
  • low

    धीमी आवाज़.

  • medium

    मध्यम पिच वाली आवाज़.

  • high

    ऊंची पिच वाली आवाज़.

prompted PromptedVoice  (ज़रूरी नहीं)

आवाज़ जनरेट करने के लिए प्रॉम्प्ट से जुड़े पैरामीटर. जब `type` की वैल्यू `"prompted"` पर सेट हो, तब `CreateVoice` में इसकी ज़रूरत होती है. प्रॉम्प्ट की गई आवाज़ों के लिए, `CreateVoice`, `GetVoice`, और `ListVoices` के जवाबों में यह दिखता है.

आवाज़ जनरेट करने के लिए प्रॉम्प्ट से जुड़े पैरामीटर. जब `type` की वैल्यू `"prompted"` पर सेट हो, तब `CreateVoice` में इसकी ज़रूरत होती है. प्रॉम्प्ट की गई आवाज़ों के लिए, `CreateVoice`, `GetVoice`, और `ListVoices` के जवाबों में यह दिखता है.

फ़ील्ड
input string  (ज़रूरी नहीं)

ज़रूरी है. नैचुरल लैंग्वेज में दिया गया प्रॉम्प्ट, जिसमें मनचाही आवाज़ के बारे में बताया गया हो. उदाहरण के लिए: "एक बूढ़े राक्षस की गहरी, गूंजने वाली पुरुष आवाज़."

region_code string  (ज़रूरी नहीं है)

ज़रूरी नहीं. ISO 3166-1 alpha-2 या UN M.49 वाला भौगोलिक क्षेत्र का कोड (जैसे, "US", "GB", "001").

sample_audio AudioData  (ज़रूरी नहीं)

सिर्फ़ आउटपुट के लिए. प्रॉम्प्ट में दी गई आवाज़ के लिए जनरेट किया गया ऑडियो (सिंथेसाइज़र प्रॉम्प्ट ऑडियो). यह सिर्फ़ `CreateVoice` और `GetVoice` के जवाबों में दिखता है. ऐसा तब होता है, जब `type` की वैल्यू `"prompted"` होती है. `ListVoices` के जवाबों में और `"replicated"` या `"prebuilt"` आवाज़ों के लिए, इसे सेट नहीं किया जाता.

आवाज़ बनाने के लिए इस्तेमाल किया गया ऑडियो पेलोड.

फ़ील्ड
data string  (ज़रूरी नहीं)

ज़रूरी है. ऑडियो के रॉ बाइट.

mime_type string  (ज़रूरी नहीं)

ज़रूरी है. ऑडियो डेटा का IANA एमआईएमई टाइप. उदाहरण के लिए, `audio/wav` या `audio/mpeg`.

type VoiceType  (ज़रूरी नहीं)

ज़रूरी है. आवाज़ का टाइप. `CreateVoice` में, इसे `"replicated"` या `"prompted"` पर सेट किया जाना चाहिए. `ListVoices` के जवाबों में, इसे `"prebuilt"` पर भी सेट किया जा सकता है.

संभावित वैल्यू
  • replicated

    कस्टम वॉइस, रेफ़रंस ऑडियो सैंपल और स्पीकर की सहमति वाली रिकॉर्डिंग से मिलती-जुलती होती है.

  • prompted

    नैचुरल लैंग्वेज वाले टेक्स्ट प्रॉम्प्ट से जनरेट की गई कस्टम वॉइस. इसमें `base_voice` में बदलाव करने या उसे रीमिक्स करने का विकल्प होता है.

  • prebuilt

    Google के वॉइस कैटलॉग में मौजूद सिस्टम की आवाज़ (जैसे, `Puck`, `Charon`). यह जवाबों में दिखती है. इसे `CreateVoice` में टाइप के तौर पर नहीं बताया जा सकता.

usage Usage  (optional)

सिर्फ़ आउटपुट के लिए. आवाज़ बनाने के अनुरोध के लिए, टोकन के इस्तेमाल के आंकड़े. यह सिर्फ़ `CreateVoice` के रिस्पॉन्स में तब दिखता है, जब `type` `"prompted"` हो. `"replicated"` के लिए इसे सेट नहीं किया जाता. साथ ही, `GetVoice` और `ListVoices` के रिस्पॉन्स में भी यह नहीं दिखता.

इंटरैक्शन के अनुरोध में इस्तेमाल किए गए टोकन के बारे में आंकड़े.

फ़ील्ड
cached_tokens_by_modality array (ModalityTokens)  (ज़रूरी नहीं)

मोड के हिसाब से, कैश मेमोरी में सेव किए गए टोकन के इस्तेमाल की जानकारी.

जवाब देने के एक तरीके के लिए टोकन की गिनती.

फ़ील्ड
modality ResponseModality  (ज़रूरी नहीं)

टोकन की गिनती से जुड़ी मोडेलिटी.

संभावित वैल्यू
  • text

    इससे पता चलता है कि मॉडल को टेक्स्ट दिखाना चाहिए.

  • image

    इससे पता चलता है कि मॉडल को इमेज जनरेट करनी चाहिए.

  • audio

    इससे पता चलता है कि मॉडल को ऑडियो वापस भेजना चाहिए.

  • video

    इससे पता चलता है कि मॉडल को वीडियो दिखाना चाहिए.

  • document

    इससे पता चलता है कि मॉडल को दस्तावेज़ दिखाने चाहिए.

tokens integer  (optional)

मोडेलिटी के लिए टोकन की संख्या.

grounding_tool_count array (GroundingToolCount)  (ज़रूरी नहीं)

ग्राउंडिंग टूल की संख्या.

ग्राउंडिंग टूल की गिनती की संख्या.

फ़ील्ड
count integer  (optional)

ग्राउंडिंग टूल की गिनती की संख्या.

type enum (string)  (ज़रूरी नहीं)

गिनती से जुड़ा ग्राउंडिंग टूल टाइप.

इस्तेमाल की जा सकने वाली वैल्यू:

  • google_search

    Google Web Search और Image Search से सटीक जानकारी पाने की सुविधा, & एंटरप्राइज़ के लिए वेब ग्राउंडिंग.

  • google_maps

    Google Maps से जानकारी लेने की सुविधा.

  • retrieval

    ग्राहक के डेटा के साथ ग्राउंडिंग, जैसे कि VertexAISearch.

input_tokens_by_modality array (ModalityTokens)  (optional)

मोड के हिसाब से, इनपुट टोकन के इस्तेमाल का ब्रेकडाउन.

जवाब देने के एक तरीके के लिए टोकन की गिनती.

फ़ील्ड
modality ResponseModality  (ज़रूरी नहीं)

टोकन की गिनती से जुड़ी मोडेलिटी.

संभावित वैल्यू
  • text

    इससे पता चलता है कि मॉडल को टेक्स्ट दिखाना चाहिए.

  • image

    इससे पता चलता है कि मॉडल को इमेज जनरेट करनी चाहिए.

  • audio

    इससे पता चलता है कि मॉडल को ऑडियो वापस भेजना चाहिए.

  • video

    इससे पता चलता है कि मॉडल को वीडियो दिखाना चाहिए.

  • document

    इससे पता चलता है कि मॉडल को दस्तावेज़ दिखाने चाहिए.

tokens integer  (optional)

मोडेलिटी के लिए टोकन की संख्या.

output_tokens_by_modality array (ModalityTokens)  (ज़रूरी नहीं)

मोड के हिसाब से, आउटपुट टोकन के इस्तेमाल की जानकारी.

जवाब देने के एक तरीके के लिए टोकन की गिनती.

फ़ील्ड
modality ResponseModality  (ज़रूरी नहीं)

टोकन की गिनती से जुड़ी मोडेलिटी.

संभावित वैल्यू
  • text

    इससे पता चलता है कि मॉडल को टेक्स्ट दिखाना चाहिए.

  • image

    इससे पता चलता है कि मॉडल को इमेज जनरेट करनी चाहिए.

  • audio

    इससे पता चलता है कि मॉडल को ऑडियो वापस भेजना चाहिए.

  • video

    इससे पता चलता है कि मॉडल को वीडियो दिखाना चाहिए.

  • document

    इससे पता चलता है कि मॉडल को दस्तावेज़ दिखाने चाहिए.

tokens integer  (optional)

मोडेलिटी के लिए टोकन की संख्या.

tool_use_tokens_by_modality array (ModalityTokens)  (optional)

मोड के हिसाब से, टूल इस्तेमाल करने के लिए टोकन के इस्तेमाल का ब्रेकडाउन.

जवाब देने के एक तरीके के लिए टोकन की गिनती.

फ़ील्ड
modality ResponseModality  (ज़रूरी नहीं)

टोकन की गिनती से जुड़ी मोडेलिटी.

संभावित वैल्यू
  • text

    इससे पता चलता है कि मॉडल को टेक्स्ट दिखाना चाहिए.

  • image

    इससे पता चलता है कि मॉडल को इमेज जनरेट करनी चाहिए.

  • audio

    इससे पता चलता है कि मॉडल को ऑडियो वापस भेजना चाहिए.

  • video

    इससे पता चलता है कि मॉडल को वीडियो दिखाना चाहिए.

  • document

    इससे पता चलता है कि मॉडल को दस्तावेज़ दिखाने चाहिए.

tokens integer  (optional)

मोडेलिटी के लिए टोकन की संख्या.

total_cached_tokens integer  (optional)

प्रॉम्प्ट के कैश मेमोरी में सेव किए गए हिस्से (कैश मेमोरी में सेव किया गया कॉन्टेंट) में मौजूद टोकन की संख्या.

total_input_tokens integer  (optional)

प्रॉम्प्ट (कॉन्टेक्स्ट) में मौजूद टोकन की संख्या.

total_output_tokens integer  (ज़रूरी नहीं)

जनरेट किए गए सभी जवाबों में मौजूद टोकन की कुल संख्या.

total_thought_tokens integer  (optional)

सूझ-बूझ वाले मॉडल के लिए, आइडिया के टोकन की संख्या.

total_tokens integer  (optional)

इंटरैक्शन के अनुरोध के लिए टोकन की कुल संख्या (प्रॉम्प्ट + जवाब + अन्य इंटरनल टोकन).

total_tool_use_tokens integer  (ज़रूरी नहीं)

टूल का इस्तेमाल करने के बारे में दिए गए निर्देश में मौजूद टोकन की संख्या.

बनाएं

ListVoices

get https://generativelanguage.googleapis.com/v1beta/voices

इस सूची में, कॉल करने वाले व्यक्ति की सेव की गई कस्टम आवाज़ें होती हैं. इन्हें सबसे नए से सबसे पुराने क्रम में लगाया जाता है. इसके बाद, Google के वॉइस कैटलॉग में मौजूद सिस्टम की पहले से तैयार की गई आवाज़ें होती हैं.

पाथ / क्वेरी पैरामीटर

accent array (string)  (ज़रूरी नहीं)

ज़रूरी नहीं. लहजे की जानकारी के हिसाब से फ़िल्टर करें. जैसे, "अमेरिकन", "ब्रिटिश". केस-इनसेंसिटिव एग्ज़ैक्ट मैच. अगर एक से ज़्यादा वैल्यू दी गई हैं, तो यह सुविधा, दिए गए किसी भी ऐक्सेंट (OR) से मिलती-जुलती आवाज़ों को पहचानती है.

context array (string)  (ज़रूरी नहीं)

ज़रूरी नहीं. कॉन्टेक्स्ट या डोमेन के हिसाब से फ़िल्टर करें. उदाहरण के लिए, "खबरें, कारोबार". केस-इनसेंसिटिव एग्ज़ैक्ट मैच. अगर एक से ज़्यादा वैल्यू दी गई हैं, तो यह पैरामीटर, बताई गई किसी भी वैल्यू से मैच करने वाली आवाज़ों को दिखाता है (OR).

gender array (string)  (ज़रूरी नहीं)

ज़रूरी नहीं. जेंडर प्रज़ेंटेशन के हिसाब से फ़िल्टर करें. जैसे, "महिला", "पुरुष", "न्यूट्रल". केस-इनसेंसिटिव एग्ज़ैक्ट मैच. अगर एक से ज़्यादा वैल्यू दी गई हैं, तो यह एट्रिब्यूट, बताई गई किसी भी लिंग (OR) के हिसाब से आवाज़ों से मैच करता है.

language_code array (string)  (ज़रूरी नहीं है)

ज़रूरी नहीं. BCP-47 भाषा कोड (जैसे, "en-US") के हिसाब से फ़िल्टर करें. केस-इनसेंसिटिव एग्ज़ैक्ट मैच. अगर एक से ज़्यादा वैल्यू दी गई हैं, तो यह एट्रिब्यूट, दी गई किसी भी भाषा के कोड (OR) से मेल खाने वाली आवाज़ों को पहचानता है.

page_size integer  (ज़रूरी नहीं)

ज़रूरी नहीं. हर पेज पर, ज़्यादा से ज़्यादा कितनी आवाज़ें दिखानी हैं. ऐसा हो सकता है कि सेवा इस वैल्यू से कम नतीजे दिखाए. अगर इसे तय नहीं किया गया है, तो ज़्यादा से ज़्यादा 50 आवाज़ें दिखाई जाती हैं. ज़्यादा से ज़्यादा वैल्यू 1,000 हो सकती है. 1,000 से ज़्यादा की वैल्यू को 1,000 माना जाता है.

page_token string  (optional)

ज़रूरी नहीं. पिछले `ListVoices` कॉल से मिला पेज टोकन. अगला पेज पाने के लिए, यह टोकन दें. पेज नंबर बदलते समय, सभी फ़िल्टर क्वेरी पैरामीटर (`language_code`, `region_code`, `accent`, `persona`, `context`, `gender`, `pitch`, `type`, और `search`) उस कॉल से मेल खाने चाहिए जिसने यह टोकन दिखाया है. ऐसा न होने पर, `INVALID_ARGUMENT` के साथ अनुरोध पूरा नहीं होगा. `page_size` पेजों के बीच बदल सकता है.

persona array (string)  (ज़रूरी नहीं)

ज़रूरी नहीं. आवाज़ की स्टाइल के हिसाब से फ़िल्टर करें. जैसे, "प्यारी और दोस्ताना". केस-इनसेंसिटिव एग्ज़ैक्ट मैच. अगर एक से ज़्यादा वैल्यू दी गई हैं, तो यह प्रॉपर्टी, बताई गई किसी भी पर्सोना (OR) से मिलती-जुलती आवाज़ों को मैच करती है.

pitch array (string)  (ज़रूरी नहीं)

ज़रूरी नहीं. आवाज़ की पिच के हिसाब से फ़िल्टर करें. यह `"low"`, `"medium"`, `"high"` वैल्यू स्वीकार करता है (केस-सेंसिटिव नहीं है). अगर एक से ज़्यादा वैल्यू दी गई हैं, तो आवाज़ें, दी गई किसी भी पिच (OR) से मैच करती हैं.

region_code array (string)  (ज़रूरी नहीं)

ज़रूरी नहीं. ISO 3166-1 ऐल्फ़ा-2 या UN M.49 रीजन कोड के हिसाब से फ़िल्टर करें. उदाहरण के लिए, "US", "001". केस-इनसेंसिटिव एग्ज़ैक्ट मैच. एक से ज़्यादा वैल्यू तय करने पर, यह फ़िल्टर किसी भी तय किए गए क्षेत्र के कोड (OR) के हिसाब से आवाज़ों को मैच करता है.

search string  (ज़रूरी नहीं)

ज़रूरी नहीं. यह एक ऐसी क्वेरी होती है जिसमें टेक्स्ट का कोई हिस्सा खोजा जाता है. इसमें केस-सेंसिटिविटी का ध्यान नहीं रखा जाता. इसकी तुलना `display_name` और `description`, दोनों से की जाती है. इसकी ज़्यादा से ज़्यादा लंबाई 2,048 बाइट होती है.

type array (string)  (ज़रूरी नहीं)

ज़रूरी नहीं. आवाज़ के टाइप के हिसाब से फ़िल्टर करें. यह `"prebuilt"`, `"replicated"`, `"prompted"` (केस-इनसेंसिटिव) को स्वीकार करता है. अगर एक से ज़्यादा वैल्यू तय की जाती हैं, तो यह तय किए गए किसी भी टाइप (OR) से मिलती-जुलती आवाज़ों को मैच करता है.

जवाब

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

next_page_token string  (optional)

यह एक ऐसा टोकन है जिसे `page_token` के तौर पर भेजा जा सकता है, ताकि अगले पेज को वापस पाया जा सके. अगर यह फ़ील्ड खाली है, तो इसका मतलब है कि इसके बाद कोई पेज नहीं है.

voices array (Voice)  (ज़रूरी नहीं)

चुने गए कलेक्शन की आवाज़ें.

सूची

GetVoice

get https://generativelanguage.googleapis.com/v1beta/voices/{voicesId}

संसाधन के नाम के हिसाब से, सेव की गई कस्टम वॉइस (`store = true`) को ऐक्सेस करता है. प्रीबिल्ट कैटलॉग की आवाज़ें (`VOICE_TYPE_PREBUILT`), `GetVoice` के ज़रिए वापस नहीं पाई जा सकतीं. इसके बजाय, `ListVoices` का इस्तेमाल करें.

पाथ / क्वेरी पैरामीटर

voicesId string  (ज़रूरी है)

ज़रूरी है. कस्टम तौर पर सेव की गई आवाज़ का संसाधन नाम, जिसे वापस पाना है (उदाहरण के लिए, `voices/voice_abc123def456`).

जवाब

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

accent string  (ज़रूरी नहीं)

ज़रूरी नहीं. क्षेत्रीय लहज़े के बारे में बताने वाला शब्द (जैसे, "अमेरिकन", "ब्रिटिश").

context string  (ज़रूरी नहीं)

ज़रूरी नहीं. इस्तेमाल का सबसे सही कॉन्टेक्स्ट या डोमेन (जैसे, "बातचीत", "ऑडियो बुक", "खबरें").

description string  (ज़रूरी नहीं)

ज़रूरी नहीं. आवाज़ की टोन, पर्सनैलिटी, और पिच के बारे में जानकारी देने वाली खास जानकारी.

display_name string  (ज़रूरी नहीं)

ज़रूरी नहीं. यह प्रॉपर्टी, सेव की गई आवाज़ (`store = true`) के लिए, उपयोगकर्ता के दिए गए डिसप्ले नेम के बारे में जानकारी देती है. इसके अलावा, यह पहले से मौजूद आवाज़ के लिए कैटलॉग नेम के बारे में भी जानकारी देती है.

expire_time string  (optional)

सिर्फ़ आउटपुट के लिए. वह टाइमस्टैंप जिस पर कस्टम तौर पर सेव की गई आवाज़ (`store = true`) या मिलती-जुलती आवाज़ की कुंजी (`store = false`) की समयसीमा खत्म हो जाती है. कस्टम तौर पर सेव की गई आवाज़ों (`store = true`) के लिए, इस समयसीमा को तब बढ़ा दिया जाता है, जब आवाज़ का इस्तेमाल स्पीच सिंथेसिस के लिए किया जाता है या `CreateVoice` में `base_voice` के तौर पर किया जाता है. पहले से मौजूद कैटलॉग की आवाज़ों (`"prebuilt"`) के लिए, इसे सेट नहीं किया जाता है. इनकी समयसीमा खत्म नहीं होती.

gender string  (ज़रूरी नहीं)

ज़रूरी नहीं. आवाज़ के लिंग की पहचान (जैसे, "महिला", "पुरुष", "तटस्थ").

id string  (ज़रूरी नहीं)

सिर्फ़ आउटपुट के लिए. आवाज़ का यूनीक आइडेंटिफ़ायर. * Google की ओर से मैनेज की जाने वाली कस्टम आवाज़ों (`store = true`) के लिए, यह जनरेट किया गया आईडी होता है. इसमें `voice_` प्रीफ़िक्स होता है. उदाहरण के लिए, `voice_abc123def456`. `GetVoice` और `DeleteVoice` में `name` के तौर पर `voices/{id}` पास करें. साथ ही, स्पीच सिंथेसिस के दौरान `SpeechConfig.voice_config.voice` (या `SpeechConfig.voice`) में सीधे तौर पर `{id}` पास करें. * पहले से मौजूद कैटलॉग की आवाज़ों (`ListVoices` से मिली `"prebuilt"`) के लिए, यह स्पीकर का नाम होता है. उदाहरण के लिए, `Puck` या `Charon`. * `CreateVoice` को `store = false` के साथ कॉल करने पर, इसे सेट नहीं किया जाता.

key string  (ज़रूरी नहीं)

सिर्फ़ आउटपुट के लिए. क्लाइंट के मैनेज की गई आवाज़ की नकल बनाने की कुंजी (प्रीफ़िक्स `voicekey_` के साथ). यह कुंजी सिर्फ़ `CreateVoice` फ़ंक्शन से तब मिलती है, जब `type` की वैल्यू `"replicated"` और `store` की वैल्यू `false` होती है. स्पीच सिंथेसिस के दौरान, इस कुंजी को `SpeechConfig.voice_config.voice` (या `SpeechConfig.voice`) को पास करें.

language_code string  (ज़रूरी नहीं)

ज़रूरी नहीं. BCP-47 का मुख्य भाषा टैग (जैसे, "en-US", "fr-FR").

model string  (ज़रूरी नहीं)

ज़रूरी नहीं. आवाज़ को डिज़ाइन करने या उसकी नकल करने के लिए इस्तेमाल किया गया मॉडल. अगर `CreateVoice` में इसे शामिल नहीं किया जाता है, तो यह डिफ़ॉल्ट रूप से, आवाज़ के डिज़ाइन वाले सबसे नए मॉडल पर सेट होता है. यह वैल्यू, `CreateVoice`, `GetVoice`, और `ListVoices` के जवाबों में मिलती है. यह वैल्यू, कस्टम आवाज़ों (`"prompted"` और `"replicated"`) के लिए सेट होती है. हालांकि, `"prebuilt"` आवाज़ों के लिए यह वैल्यू सेट नहीं होती. बनाई गई आवाज़ों को, टीटीएस के साथ काम करने वाले किसी भी सिंथेसिस मॉडल में इस्तेमाल किया जा सकता है.

persona string  (ज़रूरी नहीं)

ज़रूरी नहीं. इस्तेमाल किया जाने वाला पर्सोना या किरदार (जैसे, "मिलनसार", "नैरेटर").

पिच पिच  (ज़रूरी नहीं)

ज़रूरी नहीं. आवाज़ की पिच की कैटगरी.

संभावित वैल्यू
  • low

    धीमी आवाज़.

  • medium

    मध्यम पिच वाली आवाज़.

  • high

    ऊंची पिच वाली आवाज़.

prompted PromptedVoice  (ज़रूरी नहीं)

आवाज़ जनरेट करने के लिए प्रॉम्प्ट से जुड़े पैरामीटर. जब `type` की वैल्यू `"prompted"` पर सेट हो, तब `CreateVoice` में इसकी ज़रूरत होती है. प्रॉम्प्ट की गई आवाज़ों के लिए, `CreateVoice`, `GetVoice`, और `ListVoices` के जवाबों में यह दिखता है.

आवाज़ जनरेट करने के लिए प्रॉम्प्ट से जुड़े पैरामीटर. जब `type` की वैल्यू `"prompted"` पर सेट हो, तब `CreateVoice` में इसकी ज़रूरत होती है. प्रॉम्प्ट की गई आवाज़ों के लिए, `CreateVoice`, `GetVoice`, और `ListVoices` के जवाबों में यह दिखता है.

फ़ील्ड
input string  (ज़रूरी नहीं)

ज़रूरी है. नैचुरल लैंग्वेज में दिया गया प्रॉम्प्ट, जिसमें मनचाही आवाज़ के बारे में बताया गया हो. उदाहरण के लिए: "एक बूढ़े राक्षस की गहरी, गूंजने वाली पुरुष आवाज़."

region_code string  (ज़रूरी नहीं है)

ज़रूरी नहीं. ISO 3166-1 alpha-2 या UN M.49 वाला भौगोलिक क्षेत्र का कोड (जैसे, "US", "GB", "001").

sample_audio AudioData  (ज़रूरी नहीं)

सिर्फ़ आउटपुट के लिए. प्रॉम्प्ट में दी गई आवाज़ के लिए जनरेट किया गया ऑडियो (सिंथेसाइज़र प्रॉम्प्ट ऑडियो). यह सिर्फ़ `CreateVoice` और `GetVoice` के जवाबों में दिखता है. ऐसा तब होता है, जब `type` की वैल्यू `"prompted"` होती है. `ListVoices` के जवाबों में और `"replicated"` या `"prebuilt"` आवाज़ों के लिए, इसे सेट नहीं किया जाता.

आवाज़ बनाने के लिए इस्तेमाल किया गया ऑडियो पेलोड.

फ़ील्ड
data string  (ज़रूरी नहीं)

ज़रूरी है. ऑडियो के रॉ बाइट.

mime_type string  (ज़रूरी नहीं)

ज़रूरी है. ऑडियो डेटा का IANA एमआईएमई टाइप. उदाहरण के लिए, `audio/wav` या `audio/mpeg`.

type VoiceType  (ज़रूरी नहीं)

ज़रूरी है. आवाज़ का टाइप. `CreateVoice` में, इसे `"replicated"` या `"prompted"` पर सेट किया जाना चाहिए. `ListVoices` के जवाबों में, इसे `"prebuilt"` पर भी सेट किया जा सकता है.

संभावित वैल्यू
  • replicated

    कस्टम वॉइस, रेफ़रंस ऑडियो सैंपल और स्पीकर की सहमति वाली रिकॉर्डिंग से मिलती-जुलती होती है.

  • prompted

    नैचुरल लैंग्वेज वाले टेक्स्ट प्रॉम्प्ट से जनरेट की गई कस्टम वॉइस. इसमें `base_voice` में बदलाव करने या उसे रीमिक्स करने का विकल्प होता है.

  • prebuilt

    Google के वॉइस कैटलॉग में मौजूद सिस्टम की आवाज़ (जैसे, `Puck`, `Charon`). यह जवाबों में दिखती है. इसे `CreateVoice` में टाइप के तौर पर नहीं बताया जा सकता.

usage Usage  (optional)

सिर्फ़ आउटपुट के लिए. आवाज़ बनाने के अनुरोध के लिए, टोकन के इस्तेमाल के आंकड़े. यह सिर्फ़ `CreateVoice` के रिस्पॉन्स में तब दिखता है, जब `type` `"prompted"` हो. `"replicated"` के लिए इसे सेट नहीं किया जाता. साथ ही, `GetVoice` और `ListVoices` के रिस्पॉन्स में भी यह नहीं दिखता.

इंटरैक्शन के अनुरोध में इस्तेमाल किए गए टोकन के बारे में आंकड़े.

फ़ील्ड
cached_tokens_by_modality array (ModalityTokens)  (ज़रूरी नहीं)

मोड के हिसाब से, कैश मेमोरी में सेव किए गए टोकन के इस्तेमाल की जानकारी.

जवाब देने के एक तरीके के लिए टोकन की गिनती.

फ़ील्ड
modality ResponseModality  (ज़रूरी नहीं)

टोकन की गिनती से जुड़ी मोडेलिटी.

संभावित वैल्यू
  • text

    इससे पता चलता है कि मॉडल को टेक्स्ट दिखाना चाहिए.

  • image

    इससे पता चलता है कि मॉडल को इमेज जनरेट करनी चाहिए.

  • audio

    इससे पता चलता है कि मॉडल को ऑडियो वापस भेजना चाहिए.

  • video

    इससे पता चलता है कि मॉडल को वीडियो दिखाना चाहिए.

  • document

    इससे पता चलता है कि मॉडल को दस्तावेज़ दिखाने चाहिए.

tokens integer  (optional)

मोडेलिटी के लिए टोकन की संख्या.

grounding_tool_count array (GroundingToolCount)  (ज़रूरी नहीं)

ग्राउंडिंग टूल की संख्या.

ग्राउंडिंग टूल की गिनती की संख्या.

फ़ील्ड
count integer  (optional)

ग्राउंडिंग टूल की गिनती की संख्या.

type enum (string)  (ज़रूरी नहीं)

गिनती से जुड़ा ग्राउंडिंग टूल टाइप.

इस्तेमाल की जा सकने वाली वैल्यू:

  • google_search

    Google Web Search और Image Search से सटीक जानकारी पाने की सुविधा, & एंटरप्राइज़ के लिए वेब ग्राउंडिंग.

  • google_maps

    Google Maps से जानकारी लेने की सुविधा.

  • retrieval

    ग्राहक के डेटा के साथ ग्राउंडिंग, जैसे कि VertexAISearch.

input_tokens_by_modality array (ModalityTokens)  (optional)

मोड के हिसाब से, इनपुट टोकन के इस्तेमाल का ब्रेकडाउन.

जवाब देने के एक तरीके के लिए टोकन की गिनती.

फ़ील्ड
modality ResponseModality  (ज़रूरी नहीं)

टोकन की गिनती से जुड़ी मोडेलिटी.

संभावित वैल्यू
  • text

    इससे पता चलता है कि मॉडल को टेक्स्ट दिखाना चाहिए.

  • image

    इससे पता चलता है कि मॉडल को इमेज जनरेट करनी चाहिए.

  • audio

    इससे पता चलता है कि मॉडल को ऑडियो वापस भेजना चाहिए.

  • video

    इससे पता चलता है कि मॉडल को वीडियो दिखाना चाहिए.

  • document

    इससे पता चलता है कि मॉडल को दस्तावेज़ दिखाने चाहिए.

tokens integer  (optional)

मोडेलिटी के लिए टोकन की संख्या.

output_tokens_by_modality array (ModalityTokens)  (ज़रूरी नहीं)

मोड के हिसाब से, आउटपुट टोकन के इस्तेमाल की जानकारी.

जवाब देने के एक तरीके के लिए टोकन की गिनती.

फ़ील्ड
modality ResponseModality  (ज़रूरी नहीं)

टोकन की गिनती से जुड़ी मोडेलिटी.

संभावित वैल्यू
  • text

    इससे पता चलता है कि मॉडल को टेक्स्ट दिखाना चाहिए.

  • image

    इससे पता चलता है कि मॉडल को इमेज जनरेट करनी चाहिए.

  • audio

    इससे पता चलता है कि मॉडल को ऑडियो वापस भेजना चाहिए.

  • video

    इससे पता चलता है कि मॉडल को वीडियो दिखाना चाहिए.

  • document

    इससे पता चलता है कि मॉडल को दस्तावेज़ दिखाने चाहिए.

tokens integer  (optional)

मोडेलिटी के लिए टोकन की संख्या.

tool_use_tokens_by_modality array (ModalityTokens)  (optional)

मोड के हिसाब से, टूल इस्तेमाल करने के लिए टोकन के इस्तेमाल का ब्रेकडाउन.

जवाब देने के एक तरीके के लिए टोकन की गिनती.

फ़ील्ड
modality ResponseModality  (ज़रूरी नहीं)

टोकन की गिनती से जुड़ी मोडेलिटी.

संभावित वैल्यू
  • text

    इससे पता चलता है कि मॉडल को टेक्स्ट दिखाना चाहिए.

  • image

    इससे पता चलता है कि मॉडल को इमेज जनरेट करनी चाहिए.

  • audio

    इससे पता चलता है कि मॉडल को ऑडियो वापस भेजना चाहिए.

  • video

    इससे पता चलता है कि मॉडल को वीडियो दिखाना चाहिए.

  • document

    इससे पता चलता है कि मॉडल को दस्तावेज़ दिखाने चाहिए.

tokens integer  (optional)

मोडेलिटी के लिए टोकन की संख्या.

total_cached_tokens integer  (optional)

प्रॉम्प्ट के कैश मेमोरी में सेव किए गए हिस्से (कैश मेमोरी में सेव किया गया कॉन्टेंट) में मौजूद टोकन की संख्या.

total_input_tokens integer  (optional)

प्रॉम्प्ट (कॉन्टेक्स्ट) में मौजूद टोकन की संख्या.

total_output_tokens integer  (ज़रूरी नहीं)

जनरेट किए गए सभी जवाबों में मौजूद टोकन की कुल संख्या.

total_thought_tokens integer  (optional)

सूझ-बूझ वाले मॉडल के लिए, आइडिया के टोकन की संख्या.

total_tokens integer  (optional)

इंटरैक्शन के अनुरोध के लिए टोकन की कुल संख्या (प्रॉम्प्ट + जवाब + अन्य इंटरनल टोकन).

total_tool_use_tokens integer  (ज़रूरी नहीं)

टूल का इस्तेमाल करने के लिए दिए गए प्रॉम्प्ट में मौजूद टोकन की संख्या.

पाएं

DeleteVoice

delete https://generativelanguage.googleapis.com/v1beta/voices/{voicesId}

यह संसाधन के नाम के हिसाब से, सेव की गई कस्टम वॉइस (`store = true`) को मिटाता है. पहले से तैयार की गई कैटलॉग की आवाज़ों (`VOICE_TYPE_PREBUILT`) को मिटाया नहीं जा सकता.

पाथ / क्वेरी पैरामीटर

voicesId string  (ज़रूरी है)

ज़रूरी है. मिटाने के लिए, कस्टम तौर पर सेव की गई आवाज़ का संसाधन नाम (उदाहरण के लिए, `voices/voice_abc123def456`).

जवाब

अगर अनुरोध पूरा हो जाता है, तो जवाब में कुछ नहीं होता.

मिटाएं
संसाधन

Google Voice

यह एक वॉइस रिसॉर्स है. यह कस्टम वॉइस (इसे `CreateVoice` के ज़रिए बनाया जाता है) या पहले से बनी सिस्टम वॉइस (इसे `ListVoices` से वापस लाया जाता है) को दिखाता है.

फ़ील्ड
accent string  (ज़रूरी नहीं)

ज़रूरी नहीं. क्षेत्रीय लहज़े के बारे में बताने वाला शब्द (जैसे, "अमेरिकन", "ब्रिटिश").

context string  (ज़रूरी नहीं)

ज़रूरी नहीं. इस्तेमाल का सबसे सही कॉन्टेक्स्ट या डोमेन (जैसे, "बातचीत", "ऑडियो बुक", "खबरें").

description string  (ज़रूरी नहीं)

ज़रूरी नहीं. आवाज़ की टोन, पर्सनैलिटी, और पिच के बारे में जानकारी देने वाली खास जानकारी.

display_name string  (ज़रूरी नहीं)

ज़रूरी नहीं. यह प्रॉपर्टी, सेव की गई आवाज़ (`store = true`) के लिए, उपयोगकर्ता के दिए गए डिसप्ले नेम के बारे में जानकारी देती है. इसके अलावा, यह पहले से मौजूद आवाज़ के लिए कैटलॉग नेम के बारे में भी जानकारी देती है.

expire_time string  (optional)

सिर्फ़ आउटपुट के लिए. वह टाइमस्टैंप जिस पर कस्टम तौर पर सेव की गई आवाज़ (`store = true`) या मिलती-जुलती आवाज़ की कुंजी (`store = false`) की समयसीमा खत्म हो जाती है. कस्टम तौर पर सेव की गई आवाज़ों (`store = true`) के लिए, इस समयसीमा को तब बढ़ा दिया जाता है, जब आवाज़ का इस्तेमाल स्पीच सिंथेसिस के लिए किया जाता है या `CreateVoice` में `base_voice` के तौर पर किया जाता है. पहले से मौजूद कैटलॉग की आवाज़ों (`"prebuilt"`) के लिए, इसे सेट नहीं किया जाता है. इनकी समयसीमा खत्म नहीं होती.

gender string  (ज़रूरी नहीं)

ज़रूरी नहीं. आवाज़ के लिंग की पहचान (जैसे, "महिला", "पुरुष", "तटस्थ").

id string  (ज़रूरी नहीं)

सिर्फ़ आउटपुट के लिए. आवाज़ का यूनीक आइडेंटिफ़ायर. * Google की ओर से मैनेज की जाने वाली कस्टम आवाज़ों (`store = true`) के लिए, यह जनरेट किया गया आईडी होता है. इसमें `voice_` प्रीफ़िक्स होता है. उदाहरण के लिए, `voice_abc123def456`. `GetVoice` और `DeleteVoice` में `name` के तौर पर `voices/{id}` पास करें. साथ ही, स्पीच सिंथेसिस के दौरान `SpeechConfig.voice_config.voice` (या `SpeechConfig.voice`) में सीधे तौर पर `{id}` पास करें. * पहले से मौजूद कैटलॉग की आवाज़ों (`ListVoices` से मिली `"prebuilt"`) के लिए, यह स्पीकर का नाम होता है. उदाहरण के लिए, `Puck` या `Charon`. * `CreateVoice` को `store = false` के साथ कॉल करने पर, इसे सेट नहीं किया जाता.

key string  (ज़रूरी नहीं)

सिर्फ़ आउटपुट के लिए. क्लाइंट के मैनेज की गई आवाज़ की नकल बनाने की कुंजी (प्रीफ़िक्स `voicekey_` के साथ). यह कुंजी सिर्फ़ `CreateVoice` फ़ंक्शन से तब मिलती है, जब `type` की वैल्यू `"replicated"` और `store` की वैल्यू `false` होती है. स्पीच सिंथेसिस के दौरान, इस कुंजी को `SpeechConfig.voice_config.voice` (या `SpeechConfig.voice`) को पास करें.

language_code string  (ज़रूरी नहीं)

ज़रूरी नहीं. BCP-47 का मुख्य भाषा टैग (जैसे, "en-US", "fr-FR").

model string  (ज़रूरी नहीं)

ज़रूरी नहीं. आवाज़ को डिज़ाइन करने या उसकी नकल करने के लिए इस्तेमाल किया गया मॉडल. अगर `CreateVoice` में इसे शामिल नहीं किया जाता है, तो यह डिफ़ॉल्ट रूप से, आवाज़ के डिज़ाइन वाले सबसे नए मॉडल पर सेट होता है. यह वैल्यू, `CreateVoice`, `GetVoice`, और `ListVoices` के जवाबों में मिलती है. यह वैल्यू, कस्टम आवाज़ों (`"prompted"` और `"replicated"`) के लिए सेट होती है. हालांकि, `"prebuilt"` आवाज़ों के लिए यह वैल्यू सेट नहीं होती. बनाई गई आवाज़ों को, टीटीएस के साथ काम करने वाले किसी भी सिंथेसिस मॉडल में इस्तेमाल किया जा सकता है.

persona string  (ज़रूरी नहीं)

ज़रूरी नहीं. इस्तेमाल किया जाने वाला पर्सोना या किरदार (जैसे, "मिलनसार", "नैरेटर").

पिच पिच  (ज़रूरी नहीं)

ज़रूरी नहीं. आवाज़ की पिच की कैटगरी.

संभावित वैल्यू
  • low

    धीमी आवाज़.

  • medium

    मध्यम पिच वाली आवाज़.

  • high

    ऊंची पिच वाली आवाज़.

prompted PromptedVoice  (ज़रूरी नहीं)

आवाज़ जनरेट करने के लिए प्रॉम्प्ट से जुड़े पैरामीटर. जब `type` की वैल्यू `"prompted"` पर सेट हो, तब `CreateVoice` में इसकी ज़रूरत होती है. प्रॉम्प्ट की गई आवाज़ों के लिए, `CreateVoice`, `GetVoice`, और `ListVoices` के जवाबों में यह दिखता है.

आवाज़ जनरेट करने के लिए प्रॉम्प्ट से जुड़े पैरामीटर. जब `type` की वैल्यू `"prompted"` पर सेट हो, तब `CreateVoice` में इसकी ज़रूरत होती है. प्रॉम्प्ट की गई आवाज़ों के लिए, `CreateVoice`, `GetVoice`, और `ListVoices` के जवाबों में यह दिखता है.

फ़ील्ड
input string  (ज़रूरी नहीं)

ज़रूरी है. नैचुरल लैंग्वेज में दिया गया प्रॉम्प्ट, जिसमें मनचाही आवाज़ के बारे में बताया गया हो. उदाहरण के लिए: "एक बूढ़े राक्षस की गहरी, गूंजने वाली पुरुष आवाज़."

region_code string  (ज़रूरी नहीं है)

ज़रूरी नहीं. ISO 3166-1 alpha-2 या UN M.49 वाला भौगोलिक क्षेत्र का कोड (जैसे, "US", "GB", "001").

sample_audio AudioData  (ज़रूरी नहीं)

सिर्फ़ आउटपुट के लिए. प्रॉम्प्ट में दी गई आवाज़ के लिए जनरेट किया गया ऑडियो (सिंथेसाइज़र प्रॉम्प्ट ऑडियो). यह सिर्फ़ `CreateVoice` और `GetVoice` के जवाबों में दिखता है. ऐसा तब होता है, जब `type` की वैल्यू `"prompted"` होती है. `ListVoices` के जवाबों में और `"replicated"` या `"prebuilt"` आवाज़ों के लिए, इसे सेट नहीं किया जाता.

आवाज़ बनाने के लिए इस्तेमाल किया गया ऑडियो पेलोड.

फ़ील्ड
data string  (ज़रूरी नहीं)

ज़रूरी है. ऑडियो के रॉ बाइट.

mime_type string  (ज़रूरी नहीं)

ज़रूरी है. ऑडियो डेटा का IANA एमआईएमई टाइप. उदाहरण के लिए, `audio/wav` या `audio/mpeg`.

type VoiceType  (ज़रूरी नहीं)

ज़रूरी है. आवाज़ का टाइप. `CreateVoice` में, इसे `"replicated"` या `"prompted"` पर सेट किया जाना चाहिए. `ListVoices` के जवाबों में, इसे `"prebuilt"` पर भी सेट किया जा सकता है.

संभावित वैल्यू
  • replicated

    कस्टम वॉइस, रेफ़रंस ऑडियो सैंपल और स्पीकर की सहमति वाली रिकॉर्डिंग से मिलती-जुलती होती है.

  • prompted

    नैचुरल लैंग्वेज वाले टेक्स्ट प्रॉम्प्ट से जनरेट की गई कस्टम वॉइस. इसमें `base_voice` में बदलाव करने या उसे रीमिक्स करने का विकल्प होता है.

  • prebuilt

    Google के वॉइस कैटलॉग में मौजूद सिस्टम की आवाज़ (जैसे, `Puck`, `Charon`). यह जवाबों में दिखती है. इसे `CreateVoice` में टाइप के तौर पर नहीं बताया जा सकता.

usage Usage  (optional)

सिर्फ़ आउटपुट के लिए. आवाज़ बनाने के अनुरोध के लिए, टोकन के इस्तेमाल के आंकड़े. यह सिर्फ़ `CreateVoice` के रिस्पॉन्स में तब दिखता है, जब `type` `"prompted"` हो. `"replicated"` के लिए इसे सेट नहीं किया जाता. साथ ही, `GetVoice` और `ListVoices` के रिस्पॉन्स में भी इसे सेट नहीं किया जाता.

इंटरैक्शन के अनुरोध में इस्तेमाल किए गए टोकन के बारे में आंकड़े.

फ़ील्ड
cached_tokens_by_modality array (ModalityTokens)  (ज़रूरी नहीं)

मोड के हिसाब से, कैश मेमोरी में सेव किए गए टोकन के इस्तेमाल की जानकारी.

जवाब देने के एक तरीके के लिए टोकन की गिनती.

फ़ील्ड
modality ResponseModality  (ज़रूरी नहीं)

टोकन की गिनती से जुड़ी मोडेलिटी.

संभावित वैल्यू
  • text

    इससे पता चलता है कि मॉडल को टेक्स्ट दिखाना चाहिए.

  • image

    इससे पता चलता है कि मॉडल को इमेज जनरेट करनी चाहिए.

  • audio

    इससे पता चलता है कि मॉडल को ऑडियो वापस भेजना चाहिए.

  • video

    इससे पता चलता है कि मॉडल को वीडियो दिखाना चाहिए.

  • document

    इससे पता चलता है कि मॉडल को दस्तावेज़ दिखाने चाहिए.

tokens integer  (optional)

मोडेलिटी के लिए टोकन की संख्या.

grounding_tool_count array (GroundingToolCount)  (ज़रूरी नहीं)

ग्राउंडिंग टूल की संख्या.

ग्राउंडिंग टूल की गिनती की संख्या.

फ़ील्ड
count integer  (optional)

ग्राउंडिंग टूल की गिनती की संख्या.

type enum (string)  (ज़रूरी नहीं)

गिनती से जुड़ा ग्राउंडिंग टूल टाइप.

इस्तेमाल की जा सकने वाली वैल्यू:

  • google_search

    Google Web Search और Image Search से सटीक जानकारी पाने की सुविधा, & एंटरप्राइज़ के लिए वेब ग्राउंडिंग.

  • google_maps

    Google Maps से जानकारी लेने की सुविधा.

  • retrieval

    ग्राहक के डेटा के साथ ग्राउंडिंग, जैसे कि VertexAISearch.

input_tokens_by_modality array (ModalityTokens)  (optional)

मोड के हिसाब से, इनपुट टोकन के इस्तेमाल का ब्रेकडाउन.

जवाब देने के एक तरीके के लिए टोकन की गिनती.

फ़ील्ड
modality ResponseModality  (ज़रूरी नहीं)

टोकन की गिनती से जुड़ी मोडेलिटी.

संभावित वैल्यू
  • text

    इससे पता चलता है कि मॉडल को टेक्स्ट दिखाना चाहिए.

  • image

    इससे पता चलता है कि मॉडल को इमेज जनरेट करनी चाहिए.

  • audio

    इससे पता चलता है कि मॉडल को ऑडियो वापस भेजना चाहिए.

  • video

    इससे पता चलता है कि मॉडल को वीडियो दिखाना चाहिए.

  • document

    इससे पता चलता है कि मॉडल को दस्तावेज़ दिखाने चाहिए.

tokens integer  (optional)

मोडेलिटी के लिए टोकन की संख्या.

output_tokens_by_modality array (ModalityTokens)  (ज़रूरी नहीं)

मोड के हिसाब से, आउटपुट टोकन के इस्तेमाल की जानकारी.

जवाब देने के एक तरीके के लिए टोकन की गिनती.

फ़ील्ड
modality ResponseModality  (ज़रूरी नहीं)

टोकन की गिनती से जुड़ी मोडेलिटी.

संभावित वैल्यू
  • text

    इससे पता चलता है कि मॉडल को टेक्स्ट दिखाना चाहिए.

  • image

    इससे पता चलता है कि मॉडल को इमेज जनरेट करनी चाहिए.

  • audio

    इससे पता चलता है कि मॉडल को ऑडियो वापस भेजना चाहिए.

  • video

    इससे पता चलता है कि मॉडल को वीडियो दिखाना चाहिए.

  • document

    इससे पता चलता है कि मॉडल को दस्तावेज़ दिखाने चाहिए.

tokens integer  (optional)

मोडेलिटी के लिए टोकन की संख्या.

tool_use_tokens_by_modality array (ModalityTokens)  (optional)

मोड के हिसाब से, टूल इस्तेमाल करने के लिए टोकन के इस्तेमाल का ब्रेकडाउन.

जवाब देने के एक तरीके के लिए टोकन की गिनती.

फ़ील्ड
modality ResponseModality  (ज़रूरी नहीं)

टोकन की गिनती से जुड़ी मोडेलिटी.

संभावित वैल्यू
  • text

    इससे पता चलता है कि मॉडल को टेक्स्ट दिखाना चाहिए.

  • image

    इससे पता चलता है कि मॉडल को इमेज जनरेट करनी चाहिए.

  • audio

    इससे पता चलता है कि मॉडल को ऑडियो वापस भेजना चाहिए.

  • video

    इससे पता चलता है कि मॉडल को वीडियो दिखाना चाहिए.

  • document

    इससे पता चलता है कि मॉडल को दस्तावेज़ दिखाने चाहिए.

tokens integer  (optional)

मोडेलिटी के लिए टोकन की संख्या.

total_cached_tokens integer  (optional)

प्रॉम्प्ट के कैश मेमोरी में सेव किए गए हिस्से (कैश मेमोरी में सेव किया गया कॉन्टेंट) में मौजूद टोकन की संख्या.

total_input_tokens integer  (optional)

प्रॉम्प्ट (कॉन्टेक्स्ट) में मौजूद टोकन की संख्या.

total_output_tokens integer  (ज़रूरी नहीं)

जनरेट किए गए सभी जवाबों में मौजूद टोकन की कुल संख्या.

total_thought_tokens integer  (optional)

सूझ-बूझ वाले मॉडल के लिए, आइडिया के टोकन की संख्या.

total_tokens integer  (optional)

इंटरैक्शन के अनुरोध के लिए टोकन की कुल संख्या (प्रॉम्प्ट + जवाब + अन्य इंटरनल टोकन).

total_tool_use_tokens integer  (ज़रूरी नहीं)

टूल का इस्तेमाल करने के लिए दिए गए प्रॉम्प्ट में मौजूद टोकन की संख्या.