Gemini Interactions API, एक एक्सपेरिमेंटल एपीआई है. इसकी मदद से डेवलपर, Gemini के मॉडल का इस्तेमाल करके जनरेटिव एआई ऐप्लिकेशन बना सकते हैं. Gemini हमारा सबसे बेहतरीन मॉडल है. इसे शुरुआत से ही मल्टीमॉडल बनाने के लिए काम किया गया है. यह अलग-अलग तरह की जानकारी को आसानी से समझ सकता है और उसे एक साथ इस्तेमाल कर सकता है. जैसे, भाषा, इमेज, ऑडियो, वीडियो, और कोड. Gemini API का इस्तेमाल, कई कामों के लिए किया जा सकता है. जैसे, टेक्स्ट और इमेज के आधार पर तर्क देना, कॉन्टेंट जनरेट करना, बातचीत करने वाले एजेंट बनाना, खास जानकारी देने और कॉन्टेंट को अलग-अलग कैटगरी में बांटने वाले सिस्टम बनाना.
इंटरैक्शन बनाना
यह कुकी, नई बातचीत बनाती है.
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल होता है:
model ModelOption (ज़रूरी नहीं)
इंटरैक्शन जनरेट करने के लिए इस्तेमाल किए गए `Model` का नाम.
अगर `agent` नहीं दिया गया है, तो यह प्रॉपर्टी ज़रूरी है.
ये वैल्यू हो सकती हैं:
-
gemini-2.5-computer-use-preview-10-2025यह एजेंटिक क्षमता वाला मॉडल है. इसे सीधे तौर पर इंटरफ़ेस के साथ इंटरैक्ट करने के लिए डिज़ाइन किया गया है. इससे Gemini को डिजिटल एनवायरमेंट को समझने और उनमें नेविगेट करने में मदद मिलती है.
-
gemini-2.5-flashयह हमारा पहला हाइब्रिड रीज़निंग मॉडल है. इसमें 10 लाख टोकन वाली कॉन्टेक्स्ट विंडो और थिंकिंग बजट की सुविधा है.
-
gemini-2.5-flash-imageइमेज जनरेट करने वाला हमारा मॉडल, तेज़ी से काम करने, ज़रूरत के हिसाब से बदलाव करने, और कॉन्टेक्स्ट को समझने के लिए ऑप्टिमाइज़ किया गया है. टेक्स्ट इनपुट और आउटपुट की कीमत, 2.5 फ़्लैश के बराबर होती है.
-
gemini-2.5-flash-liteयह हमारा सबसे छोटा और किफ़ायती मॉडल है. इसे बड़े पैमाने पर इस्तेमाल करने के लिए बनाया गया है.
-
gemini-2.5-flash-lite-preview-09-2025यह Gemini 2.5 Flash Lite पर आधारित नया मॉडल है. इसे कम लागत, ज़्यादा थ्रूपुट, और बेहतर क्वालिटी के लिए ऑप्टिमाइज़ किया गया है.
-
gemini-2.5-flash-native-audio-preview-12-2025हमारे नेटिव ऑडियो मॉडल, बेहतर पेसिंग, आवाज़ की नैचुरैलिटी, शब्दों की संख्या, और मूड के साथ-साथ बेहतर क्वालिटी वाले ऑडियो आउटपुट के लिए ऑप्टिमाइज़ किए गए हैं.
-
gemini-2.5-flash-preview-09-2025यह 2.5 Flash मॉडल पर आधारित सबसे नया मॉडल है. 2.5 फ़्लैश प्रीव्यू, बड़े पैमाने पर प्रोसेसिंग, कम समय में जवाब देने, और ज़्यादा वॉल्यूम वाले ऐसे कामों के लिए सबसे अच्छा है जिनमें सोच-विचार करने की ज़रूरत होती है. साथ ही, यह एजेंट के इस्तेमाल के मामलों के लिए भी सबसे अच्छा है.
-
gemini-2.5-flash-preview-ttsलिखे गए शब्दों को बोली में बदलने वाला हमारा 2.5 Flash मॉडल, कम समय में बोली जनरेट करने के लिए ऑप्टिमाइज़ किया गया है.
-
gemini-2.5-proयह हमारा सबसे बेहतरीन मॉडल है. यह कोडिंग और मुश्किल सवालों के जवाब देने में माहिर है.
-
gemini-2.5-pro-preview-ttsलिखाई को बोली में बदलने वाला हमारा 2.5 Pro ऑडियो मॉडल, कम समय में तेज़ी से बोली जनरेट करने के लिए ऑप्टिमाइज़ किया गया है. इससे ज़्यादा नैचुरल आउटपुट मिलते हैं और प्रॉम्प्ट को आसानी से कंट्रोल किया जा सकता है.
-
gemini-3-flash-previewयह हमारा सबसे स्मार्ट मॉडल है. इसे तेज़ी से काम करने के लिए बनाया गया है. इसमें फ़्रंटियर इंटेलिजेंस के साथ-साथ, बेहतर खोज और ग्राउंडिंग की सुविधा भी मिलती है.
-
gemini-3-pro-image-previewइमेज जनरेट करने और उनमें बदलाव करने वाला बेहतरीन मॉडल.
-
gemini-3-pro-previewयह हमारा सबसे इंटेलिजेंट मॉडल है. इसमें एसओटीए रीज़निंग और मल्टीमॉडल को समझने की क्षमता है. साथ ही, इसमें एजेंटिक और वाइब कोडिंग की दमदार सुविधाएँ हैं.
-
gemini-3.1-pro-previewयह हमारा सबसे नया और बेहतरीन रीज़निंग मॉडल है. इसमें पहले से ज़्यादा गहराई और बारीकी से जानकारी मिलती है. साथ ही, यह टेक्स्ट, इमेज वगैरह को प्रोसेस करने और कोडिंग करने के मामले में भी ज़्यादा बेहतर है.
-
gemini-3.1-flash-image-previewतेज़ी से काम करने की क्षमता और असलियत के हिसाब से इमेज जनरेट करने की सुविधाओं के साथ, प्रो-लेवल की विज़ुअल इंटेलिजेंस.
-
gemini-3.1-flash-lite-previewयह हमारा सबसे किफ़ायती मॉडल है. इसे एजेंटिक टास्क, अनुवाद, और डेटा प्रोसेसिंग जैसे कामों के लिए ऑप्टिमाइज़ किया गया है.
-
gemini-3.1-flash-tts-previewGemini 3.1 Flash TTS: यह मॉडल, कम समय में बेहतर तरीके से बोली जनरेट करता है. इसमें आपको नैचुरल आउटपुट, प्रॉम्प्ट को कंट्रोल करने की सुविधा, और सटीक नैरेशन कंट्रोल के लिए नए एक्सप्रेसिव ऑडियो टैग मिलते हैं.
-
lyria-3-clip-previewयह कम समय में संगीत जनरेट करने वाला मॉडल है. इसे हाई-फ़िडेलिटी ऑडियो क्लिप और सटीक लय कंट्रोल के लिए ऑप्टिमाइज़ किया गया है.
-
lyria-3-pro-previewयह पूरा गाना जनरेट करने वाला हमारा ऐडवांस मॉडल है. यह संगीत की बारीकियों को अच्छी तरह से समझता है. इसे अलग-अलग म्यूज़िकल स्टाइल में सटीक स्ट्रक्चर कंट्रोल और मुश्किल ट्रांज़िशन के लिए ऑप्टिमाइज़ किया गया है.
agent AgentOption (ज़रूरी नहीं)
इंटरैक्शन जनरेट करने के लिए इस्तेमाल किए गए `Agent` का नाम.
अगर `model` एट्रिब्यूट की वैल्यू नहीं दी गई है, तो यह एट्रिब्यूट ज़रूरी है.
ये वैल्यू हो सकती हैं:
-
deep-research-pro-preview-12-2025Gemini की Deep Research सुविधा देने वाला एजेंट
-
deep-research-preview-04-2026Gemini की Deep Research सुविधा देने वाला एजेंट
-
deep-research-max-preview-04-2026Gemini Deep Research Max Agent
इंटरैक्शन के लिए इनपुट (मॉडल और एजेंट, दोनों के लिए एक जैसे होते हैं).
इंटरैक्शन के लिए सिस्टम के निर्देश.
टूल के उन एलान की सूची जिन्हें मॉडल, इंटरैक्शन के दौरान कॉल कर सकता है.
इससे यह पक्का किया जाता है कि जनरेट किया गया रिस्पॉन्स, एक JSON ऑब्जेक्ट हो. साथ ही, यह इस फ़ील्ड में दिए गए JSON स्कीमा के मुताबिक हो.
जवाब का MIME टाइप. अगर response_format सेट किया गया है, तो यह ज़रूरी है.
सिर्फ़ इनपुट के लिए. क्या इंटरैक्शन को स्ट्रीम किया जाएगा.
सिर्फ़ इनपुट के लिए. जवाब और अनुरोध को बाद में वापस पाने के लिए सेव करना है या नहीं.
सिर्फ़ इनपुट के लिए. मॉडल इंटरैक्शन को बैकग्राउंड में चलाना है या नहीं.
generation_config GenerationConfig (optional)
मॉडल कॉन्फ़िगरेशन
मॉडल इंटरैक्शन के लिए कॉन्फ़िगरेशन पैरामीटर.
`agent_config` का विकल्प. यह सिर्फ़ तब लागू होता है, जब `model` सेट किया गया हो.
फ़ील्ड
इससे आउटपुट में रैंडमनेस को कंट्रोल किया जाता है.
सैंपलिंग करते समय, टोकन की ज़्यादा से ज़्यादा संचयी संभावना पर विचार किया जाता है.
डिकोडिंग में इस्तेमाल किया गया सीड, ताकि नतीजे को फिर से जनरेट किया जा सके.
वर्णों के ऐसे क्रम की सूची जिनसे आउटपुट इंटरैक्शन बंद हो जाएगा.
thinking_level ThinkingLevel (optional)
मॉडल को कितने थॉट टोकन जनरेट करने चाहिए.
ये वैल्यू हो सकती हैं:
-
minimal -
low -
medium -
high
thinking_summaries ThinkingSummaries (ज़रूरी नहीं)
जवाब में, सोच की खास जानकारी शामिल करनी है या नहीं.
ये वैल्यू हो सकती हैं:
-
auto -
none
जवाब में शामिल किए जाने वाले टोकन की ज़्यादा से ज़्यादा संख्या.
speech_config SpeechConfig (ज़रूरी नहीं)
बोलकर इंटरैक्ट करने की सुविधा के लिए कॉन्फ़िगरेशन.
फ़ील्ड
स्पीकर की आवाज़.
बोली जाने वाली भाषा.
वक्ता का नाम, यह प्रॉम्प्ट में दिए गए वक्ता के नाम से मेल खाना चाहिए.
image_config ImageConfig (optional)
इमेज इंटरैक्शन के लिए कॉन्फ़िगरेशन.
फ़ील्ड
कोई विवरण नहीं दिया गया.
ये वैल्यू हो सकती हैं:
-
1:1 -
2:3 -
3:2 -
3:4 -
4:3 -
4:5 -
5:4 -
9:16 -
16:9 -
21:9 -
1:8 -
8:1 -
1:4 -
4:1
कोई विवरण नहीं दिया गया.
ये वैल्यू हो सकती हैं:
-
1K -
2K -
4K -
512
टूल चुनने की सुविधा का कॉन्फ़िगरेशन.
agent_config object (ज़रूरी नहीं)
एजेंट कॉन्फ़िगरेशन
एजेंट के लिए कॉन्फ़िगरेशन.
`generation_config` का विकल्प. यह सिर्फ़ तब लागू होता है, जब `agent` सेट किया गया हो.
संभावित टाइप
पॉलीमॉर्फ़िक डिसक्रिमिनेटर: type
DynamicAgentConfig
डाइनैमिक एजेंट के लिए कॉन्फ़िगरेशन.
कोई विवरण नहीं दिया गया.
इसे हमेशा "dynamic" पर सेट किया जाता है.
DeepResearchAgentConfig
Deep Research एजेंट के लिए कॉन्फ़िगरेशन.
कोई विवरण नहीं दिया गया.
इसे हमेशा "deep-research" पर सेट किया जाता है.
thinking_summaries ThinkingSummaries (ज़रूरी नहीं)
जवाब में, सोच की खास जानकारी शामिल करनी है या नहीं.
ये वैल्यू हो सकती हैं:
-
auto -
none
जवाब में विज़ुअलाइज़ेशन शामिल करने हैं या नहीं.
ये वैल्यू हो सकती हैं:
-
off -
auto
इस कुकी से, Deep Research एजेंट के लिए ह्यूमन-इन-द-लूप प्लानिंग की सुविधा चालू होती है. अगर इसे true पर सेट किया जाता है, तो Deep Research एजेंट अपने जवाब में रिसर्च प्लान देगा. इसके बाद, एजेंट सिर्फ़ तब आगे बढ़ेगा, जब उपयोगकर्ता अगले टर्न में प्लान की पुष्टि करेगा.
पिछले इंटरैक्शन का आईडी. अगर कोई पिछला इंटरैक्शन नहीं है, तो यह फ़ील्ड मौजूद नहीं होता.
response_modalities ResponseModality (optional)
जवाब के लिए अनुरोध की गई मोडेलिटी (TEXT, IMAGE, AUDIO).
ये वैल्यू हो सकती हैं:
-
text -
image -
audio -
video -
document
इंटरैक्शन के लिए सेवा का टियर.
ये वैल्यू हो सकती हैं:
-
flex -
standard -
priority
जवाब
यह Interaction संसाधन दिखाता है.
सामान्य अनुरोध
प्रतिक्रिया का उदाहरण
{ "created": "2025-11-26T12:25:15Z", "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg", "model": "gemini-3-flash-preview", "object": "interaction", "outputs": [ { "text": "Hello! I'm functioning perfectly and ready to assist you.\n\nHow are you doing today?", "type": "text" } ], "role": "model", "status": "completed", "updated": "2025-11-26T12:25:15Z", "usage": { "input_tokens_by_modality": [ { "modality": "text", "tokens": 7 } ], "total_cached_tokens": 0, "total_input_tokens": 7, "total_output_tokens": 20, "total_thought_tokens": 22, "total_tokens": 49, "total_tool_use_tokens": 0 } }
Multi-turn
प्रतिक्रिया का उदाहरण
{ "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg", "model": "gemini-3-flash-preview", "status": "completed", "object": "interaction", "created": "2025-11-26T12:22:47Z", "updated": "2025-11-26T12:22:47Z", "role": "model", "outputs": [ { "type": "text", "text": "The capital of France is Paris." } ], "usage": { "input_tokens_by_modality": [ { "modality": "text", "tokens": 50 } ], "total_cached_tokens": 0, "total_input_tokens": 50, "total_output_tokens": 10, "total_thought_tokens": 0, "total_tokens": 60, "total_tool_use_tokens": 0 } }
इमेज इनपुट
प्रतिक्रिया का उदाहरण
{ "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg", "model": "gemini-3-flash-preview", "status": "completed", "object": "interaction", "created": "2025-11-26T12:22:47Z", "updated": "2025-11-26T12:22:47Z", "role": "model", "outputs": [ { "type": "text", "text": "A white humanoid robot with glowing blue eyes stands holding a red skateboard." } ], "usage": { "input_tokens_by_modality": [ { "modality": "text", "tokens": 10 }, { "modality": "image", "tokens": 258 } ], "total_cached_tokens": 0, "total_input_tokens": 268, "total_output_tokens": 20, "total_thought_tokens": 0, "total_tokens": 288, "total_tool_use_tokens": 0 } }
फ़ंक्शन कॉलिंग
प्रतिक्रिया का उदाहरण
{ "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg", "model": "gemini-3-flash-preview", "status": "requires_action", "object": "interaction", "created": "2025-11-26T12:22:47Z", "updated": "2025-11-26T12:22:47Z", "role": "model", "outputs": [ { "type": "function_call", "id": "gth23981", "name": "get_weather", "arguments": { "location": "Boston, MA" } } ], "usage": { "input_tokens_by_modality": [ { "modality": "text", "tokens": 100 } ], "total_cached_tokens": 0, "total_input_tokens": 100, "total_output_tokens": 25, "total_thought_tokens": 0, "total_tokens": 125, "total_tool_use_tokens": 50 } }
Deep Research
प्रतिक्रिया का उदाहरण
{ "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg", "agent": "deep-research-pro-preview-12-2025", "status": "completed", "object": "interaction", "created": "2025-11-26T12:22:47Z", "updated": "2025-11-26T12:22:47Z", "role": "agent", "outputs": [ { "type": "text", "text": "Here is a comprehensive research report on the current state of cancer research..." } ], "usage": { "input_tokens_by_modality": [ { "modality": "text", "tokens": 20 } ], "total_cached_tokens": 0, "total_input_tokens": 20, "total_output_tokens": 1000, "total_thought_tokens": 500, "total_tokens": 1520, "total_tool_use_tokens": 0 } }
इंटरैक्शन वापस पाना
यह क्वेरी, `Interaction.id` के आधार पर किसी इंटरैक्शन की पूरी जानकारी वापस लाती है.
पाथ / क्वेरी पैरामीटर
जिस इंटरैक्शन को वापस पाना है उसका यूनीक आइडेंटिफ़ायर.
अगर इसे 'सही है' पर सेट किया जाता है, तो जनरेट किए गए कॉन्टेंट को धीरे-धीरे स्ट्रीम किया जाएगा.
डिफ़ॉल्ट रूप से यह इस पर सेट होता है: False
ज़रूरी नहीं. यह विकल्प सेट होने पर, इवेंट आईडी से मार्क किए गए इवेंट के बाद, इंटरैक्शन स्ट्रीम को अगले चंक से फिर से शुरू करता है. इसका इस्तेमाल सिर्फ़ तब किया जा सकता है, जब `stream` सही पर सेट हो.
इसे सही पर सेट करने पर, जवाब में इनपुट शामिल किया जाता है.
डिफ़ॉल्ट रूप से यह इस पर सेट होता है: False
एपीआई के किस वर्शन का इस्तेमाल करना है.
जवाब
यह Interaction संसाधन दिखाता है.
इंटरैक्शन पाना
प्रतिक्रिया का उदाहरण
{ "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg", "model": "gemini-3-flash-preview", "status": "completed", "object": "interaction", "created": "2025-11-26T12:25:15Z", "updated": "2025-11-26T12:25:15Z", "role": "model", "outputs": [ { "type": "text", "text": "I'm doing great, thank you for asking! How can I help you today?" } ] }
इंटरैक्शन मिटाना
इस कुकी का इस्तेमाल, आईडी के हिसाब से इंटरैक्शन को मिटाने के लिए किया जाता है.
पाथ / क्वेरी पैरामीटर
मिटाने के लिए इंटरैक्शन का यूनीक आइडेंटिफ़ायर.
एपीआई के किस वर्शन का इस्तेमाल करना है.
जवाब
अगर अनुरोध पूरा हो जाता है, तो जवाब में कुछ नहीं होता.
इंटरैक्शन मिटाना
इंटरैक्शन रद्द करना
यह आईडी के हिसाब से इंटरैक्शन रद्द करता है. यह सिर्फ़ उन बैकग्राउंड इंटरैक्शन पर लागू होता है जो अब भी चल रहे हैं.
पाथ / क्वेरी पैरामीटर
जिस इंटरैक्शन को रद्द करना है उसका यूनीक आइडेंटिफ़ायर.
एपीआई के किस वर्शन का इस्तेमाल करना है.
जवाब
यह Interaction संसाधन दिखाता है.
इंटरैक्शन रद्द करें
प्रतिक्रिया का उदाहरण
{ "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg", "agent": "deep-research-pro-preview-12-2025", "status": "cancelled", "object": "interaction", "created": "2025-11-26T12:25:15Z", "updated": "2025-11-26T12:25:15Z", "role": "agent" }
संसाधन
बातचीत
इंटरैक्शन रिसॉर्स.
फ़ील्ड
model ModelOption (ज़रूरी नहीं)
इंटरैक्शन जनरेट करने के लिए इस्तेमाल किए गए `Model` का नाम.
ये वैल्यू हो सकती हैं:
-
gemini-2.5-computer-use-preview-10-2025यह एजेंटिक क्षमता वाला मॉडल है. इसे सीधे तौर पर इंटरफ़ेस के साथ इंटरैक्ट करने के लिए डिज़ाइन किया गया है. इससे Gemini को डिजिटल एनवायरमेंट को समझने और उनमें नेविगेट करने में मदद मिलती है.
-
gemini-2.5-flashयह हमारा पहला हाइब्रिड रीज़निंग मॉडल है. इसमें 10 लाख टोकन वाली कॉन्टेक्स्ट विंडो और थिंकिंग बजट की सुविधा है.
-
gemini-2.5-flash-imageइमेज जनरेट करने वाला हमारा मॉडल, तेज़ी से काम करने, ज़रूरत के हिसाब से बदलाव करने, और कॉन्टेक्स्ट को समझने के लिए ऑप्टिमाइज़ किया गया है. टेक्स्ट इनपुट और आउटपुट की कीमत, 2.5 फ़्लैश के बराबर होती है.
-
gemini-2.5-flash-liteयह हमारा सबसे छोटा और किफ़ायती मॉडल है. इसे बड़े पैमाने पर इस्तेमाल करने के लिए बनाया गया है.
-
gemini-2.5-flash-lite-preview-09-2025यह Gemini 2.5 Flash Lite पर आधारित नया मॉडल है. इसे कम लागत, ज़्यादा थ्रूपुट, और बेहतर क्वालिटी के लिए ऑप्टिमाइज़ किया गया है.
-
gemini-2.5-flash-native-audio-preview-12-2025हमारे नेटिव ऑडियो मॉडल, बेहतर पेसिंग, आवाज़ की नैचुरैलिटी, शब्दों की संख्या, और मूड के साथ-साथ बेहतर क्वालिटी वाले ऑडियो आउटपुट के लिए ऑप्टिमाइज़ किए गए हैं.
-
gemini-2.5-flash-preview-09-2025यह 2.5 Flash मॉडल पर आधारित सबसे नया मॉडल है. 2.5 फ़्लैश प्रीव्यू, बड़े पैमाने पर प्रोसेसिंग, कम समय में जवाब देने, और ज़्यादा वॉल्यूम वाले ऐसे कामों के लिए सबसे अच्छा है जिनमें सोच-विचार करने की ज़रूरत होती है. साथ ही, यह एजेंट के इस्तेमाल के मामलों के लिए भी सबसे अच्छा है.
-
gemini-2.5-flash-preview-ttsलिखे गए शब्दों को बोली में बदलने वाला हमारा 2.5 Flash मॉडल, कम समय में बोली जनरेट करने के लिए ऑप्टिमाइज़ किया गया है.
-
gemini-2.5-proयह हमारा सबसे बेहतरीन मॉडल है. यह कोडिंग और मुश्किल सवालों के जवाब देने में माहिर है.
-
gemini-2.5-pro-preview-ttsलिखाई को बोली में बदलने वाला हमारा 2.5 Pro ऑडियो मॉडल, कम समय में तेज़ी से बोली जनरेट करने के लिए ऑप्टिमाइज़ किया गया है. इससे ज़्यादा नैचुरल आउटपुट मिलते हैं और प्रॉम्प्ट को आसानी से कंट्रोल किया जा सकता है.
-
gemini-3-flash-previewयह हमारा सबसे स्मार्ट मॉडल है. इसे तेज़ी से काम करने के लिए बनाया गया है. इसमें फ़्रंटियर इंटेलिजेंस के साथ-साथ, बेहतर खोज और ग्राउंडिंग की सुविधा भी मिलती है.
-
gemini-3-pro-image-previewइमेज जनरेट करने और उनमें बदलाव करने वाला बेहतरीन मॉडल.
-
gemini-3-pro-previewयह हमारा सबसे इंटेलिजेंट मॉडल है. इसमें एसओटीए रीज़निंग और मल्टीमॉडल को समझने की क्षमता है. साथ ही, इसमें एजेंटिक और वाइब कोडिंग की दमदार सुविधाएँ हैं.
-
gemini-3.1-pro-previewयह हमारा सबसे नया और बेहतरीन रीज़निंग मॉडल है. इसमें पहले से ज़्यादा गहराई और बारीकी से जानकारी मिलती है. साथ ही, यह टेक्स्ट, इमेज वगैरह को प्रोसेस करने और कोडिंग करने के मामले में भी ज़्यादा बेहतर है.
-
gemini-3.1-flash-image-previewतेज़ी से काम करने की क्षमता और असलियत के हिसाब से इमेज जनरेट करने की सुविधाओं के साथ, प्रो-लेवल की विज़ुअल इंटेलिजेंस.
-
gemini-3.1-flash-lite-previewयह हमारा सबसे किफ़ायती मॉडल है. इसे एजेंटिक टास्क, अनुवाद, और डेटा प्रोसेसिंग जैसे कामों के लिए ऑप्टिमाइज़ किया गया है.
-
gemini-3.1-flash-tts-previewGemini 3.1 Flash TTS: यह मॉडल, कम समय में बेहतर तरीके से बोली जनरेट करता है. इसमें आपको नैचुरल आउटपुट, प्रॉम्प्ट को कंट्रोल करने की सुविधा, और सटीक नैरेशन कंट्रोल के लिए नए एक्सप्रेसिव ऑडियो टैग मिलते हैं.
-
lyria-3-clip-previewयह कम समय में संगीत जनरेट करने वाला मॉडल है. इसे हाई-फ़िडेलिटी ऑडियो क्लिप और सटीक लय कंट्रोल के लिए ऑप्टिमाइज़ किया गया है.
-
lyria-3-pro-previewयह पूरा गाना जनरेट करने वाला हमारा ऐडवांस मॉडल है. यह संगीत की बारीकियों को अच्छी तरह से समझता है. इसे अलग-अलग म्यूज़िकल स्टाइल में सटीक स्ट्रक्चर कंट्रोल और मुश्किल ट्रांज़िशन के लिए ऑप्टिमाइज़ किया गया है.
agent AgentOption (ज़रूरी नहीं)
इंटरैक्शन जनरेट करने के लिए इस्तेमाल किए गए `Agent` का नाम.
ये वैल्यू हो सकती हैं:
-
deep-research-pro-preview-12-2025Gemini की Deep Research सुविधा देने वाला एजेंट
-
deep-research-preview-04-2026Gemini की Deep Research सुविधा देने वाला एजेंट
-
deep-research-max-preview-04-2026Gemini Deep Research Max Agent
ज़रूरी है. सिर्फ़ आउटपुट के लिए. इंटरैक्शन पूरा होने के लिए यूनीक आइडेंटिफ़ायर.
ज़रूरी है. सिर्फ़ आउटपुट के लिए. इंटरैक्शन का स्टेटस.
ये वैल्यू हो सकती हैं:
-
in_progress -
requires_action -
completed -
failed -
cancelled -
incomplete
ज़रूरी है. सिर्फ़ आउटपुट के लिए. आईएसओ 8601 फ़ॉर्मैट (YYYY-MM-DDThh:mm:ssZ) में, जवाब जनरेट होने का समय.
ज़रूरी है. सिर्फ़ आउटपुट के लिए. आईएसओ 8601 फ़ॉर्मैट (YYYY-MM-DDThh:mm:ssZ) में, जवाब को पिछली बार अपडेट किए जाने का समय.
सिर्फ़ आउटपुट के लिए. इंटरैक्शन की भूमिका.
सिर्फ़ आउटपुट के लिए. मॉडल से मिले जवाब.
इंटरैक्शन के लिए सिस्टम को दिया गया निर्देश.
टूल के उन एलान की सूची जिन्हें मॉडल, इंटरैक्शन के दौरान कॉल कर सकता है.
usage Usage (ज़रूरी नहीं)
सिर्फ़ आउटपुट के लिए. इंटरैक्शन के अनुरोध में इस्तेमाल किए गए टोकन के बारे में आंकड़े.
फ़ील्ड
प्रॉम्प्ट (कॉन्टेक्स्ट) में टोकन की संख्या.
input_tokens_by_modality ModalityTokens (ज़रूरी नहीं)
मोड के हिसाब से, इनपुट टोकन के इस्तेमाल की जानकारी.
फ़ील्ड
modality ResponseModality (ज़रूरी नहीं)
टोकन की संख्या से जुड़ी मोडेलिटी.
ये वैल्यू हो सकती हैं:
-
text -
image -
audio -
video -
document
मोडेलिटी के लिए टोकन की संख्या.
प्रॉम्प्ट के कैश मेमोरी में सेव किए गए हिस्से (कैश मेमोरी में सेव किया गया कॉन्टेंट) में मौजूद टोकन की संख्या.
cached_tokens_by_modality ModalityTokens (optional)
मोड के हिसाब से, कैश मेमोरी में सेव किए गए टोकन के इस्तेमाल की जानकारी.
फ़ील्ड
modality ResponseModality (ज़रूरी नहीं)
टोकन की संख्या से जुड़ी मोडेलिटी.
ये वैल्यू हो सकती हैं:
-
text -
image -
audio -
video -
document
मोडेलिटी के लिए टोकन की संख्या.
जनरेट किए गए सभी जवाबों में मौजूद टोकन की कुल संख्या.
output_tokens_by_modality ModalityTokens (ज़रूरी नहीं)
मोड के हिसाब से, आउटपुट टोकन के इस्तेमाल का ब्रेकडाउन.
फ़ील्ड
modality ResponseModality (ज़रूरी नहीं)
टोकन की संख्या से जुड़ी मोडेलिटी.
ये वैल्यू हो सकती हैं:
-
text -
image -
audio -
video -
document
मोडेलिटी के लिए टोकन की संख्या.
टूल का इस्तेमाल करने के बारे में दिए गए प्रॉम्प्ट में मौजूद टोकन की संख्या.
tool_use_tokens_by_modality ModalityTokens (ज़रूरी नहीं)
मोड के हिसाब से, टूल का इस्तेमाल करने वाले टोकन के इस्तेमाल का ब्रेकडाउन.
फ़ील्ड
modality ResponseModality (ज़रूरी नहीं)
टोकन की संख्या से जुड़ी मोडेलिटी.
ये वैल्यू हो सकती हैं:
-
text -
image -
audio -
video -
document
मोडेलिटी के लिए टोकन की संख्या.
सूझ-बूझ वाले मॉडल के लिए, आइडिया के टोकन की संख्या.
इंटरैक्शन के अनुरोध के लिए टोकन की कुल संख्या (प्रॉम्प्ट + जवाब + अन्य इंटरनल टोकन).
response_modalities ResponseModality (ज़रूरी नहीं)
जवाब के लिए अनुरोध की गई मोडेलिटी (TEXT, IMAGE, AUDIO).
ये वैल्यू हो सकती हैं:
-
text -
image -
audio -
video -
document
इससे यह पक्का किया जाता है कि जनरेट किया गया रिस्पॉन्स, एक JSON ऑब्जेक्ट हो. साथ ही, यह इस फ़ील्ड में दिए गए JSON स्कीमा के मुताबिक हो.
जवाब का MIME टाइप. अगर response_format सेट किया गया है, तो यह ज़रूरी है.
पिछले इंटरैक्शन का आईडी. अगर कोई पिछला इंटरैक्शन नहीं है, तो यह फ़ील्ड मौजूद नहीं होता.
इंटरैक्शन के लिए सेवा का टियर.
ये वैल्यू हो सकती हैं:
-
flex -
standard -
priority
agent_config object (ज़रूरी नहीं)
एजेंट के साथ इंटरैक्शन के लिए कॉन्फ़िगरेशन पैरामीटर.
संभावित टाइप
पॉलीमॉर्फ़िक डिसक्रिमिनेटर: type
DynamicAgentConfig
डाइनैमिक एजेंट के लिए कॉन्फ़िगरेशन.
कोई विवरण नहीं दिया गया.
इसे हमेशा "dynamic" पर सेट किया जाता है.
DeepResearchAgentConfig
Deep Research एजेंट के लिए कॉन्फ़िगरेशन.
कोई विवरण नहीं दिया गया.
इसे हमेशा "deep-research" पर सेट किया जाता है.
thinking_summaries ThinkingSummaries (ज़रूरी नहीं)
जवाब में, सोच की खास जानकारी शामिल करनी है या नहीं.
ये वैल्यू हो सकती हैं:
-
auto -
none
जवाब में विज़ुअलाइज़ेशन शामिल करने हैं या नहीं.
ये वैल्यू हो सकती हैं:
-
off -
auto
इस कुकी से, Deep Research एजेंट के लिए ह्यूमन-इन-द-लूप प्लानिंग की सुविधा चालू होती है. अगर इसे true पर सेट किया जाता है, तो Deep Research एजेंट अपने जवाब में रिसर्च प्लान देगा. इसके बाद, एजेंट सिर्फ़ तब आगे बढ़ेगा, जब उपयोगकर्ता अगले टर्न में प्लान की पुष्टि करेगा.
उदाहरण
उदाहरण
{ "created": "2025-12-04T15:01:45Z", "id": "v1_ChdXS0l4YWZXTk9xbk0xZThQczhEcmlROBIXV0tJeGFmV05PcW5NMWU4UHM4RHJpUTg", "model": "gemini-3-flash-preview", "object": "interaction", "outputs": [ { "text": "Hello! I'm doing well, functioning as expected. Thank you for asking! How are you doing today?", "type": "text" } ], "role": "model", "status": "completed", "updated": "2025-12-04T15:01:45Z", "usage": { "input_tokens_by_modality": [ { "modality": "text", "tokens": 7 } ], "total_cached_tokens": 0, "total_input_tokens": 7, "total_output_tokens": 23, "total_thought_tokens": 49, "total_tokens": 79, "total_tool_use_tokens": 0 } }
डेटा मॉडल
सामग्री
जवाब का कॉन्टेंट.
संभावित टाइप
पॉलीमॉर्फ़िक डिसक्रिमिनेटर: type
TextContent
टेक्स्ट कॉन्टेंट वाला ब्लॉक.
कोई विवरण नहीं दिया गया.
इसे हमेशा "text" पर सेट किया जाता है.
ज़रूरी है. टेक्स्ट कॉन्टेंट.
annotations Annotation (ज़रूरी नहीं)
मॉडल से जनरेट किए गए कॉन्टेंट के लिए उद्धरण की जानकारी.
संभावित टाइप
पॉलीमॉर्फ़िक डिसक्रिमिनेटर: type
UrlCitation
यूआरएल उद्धरण एनोटेशन.
कोई विवरण नहीं दिया गया.
इसे हमेशा "url_citation" पर सेट किया जाता है.
यूआरएल.
यूआरएल का टाइटल.
जवाब के उस सेगमेंट की शुरुआत जिसे इस सोर्स के लिए एट्रिब्यूट किया गया है. इंडेक्स से सेगमेंट की शुरुआत का पता चलता है. इसे बाइट में मापा जाता है.
एट्रिब्यूट किए गए सेगमेंट के खत्म होने का समय (अलग से उपलब्ध).
FileCitation
फ़ाइल के उद्धरण का एनोटेशन.
कोई विवरण नहीं दिया गया.
इसे हमेशा "file_citation" पर सेट किया जाता है.
फ़ाइल का यूआरआई.
फ़ाइल का नाम.
टेक्स्ट के किसी हिस्से के लिए एट्रिब्यूट किया गया सोर्स.
जवाब के उस सेगमेंट की शुरुआत जिसे इस सोर्स के लिए एट्रिब्यूट किया गया है. इंडेक्स से सेगमेंट की शुरुआत का पता चलता है. इसे बाइट में मापा जाता है.
एट्रिब्यूट किए गए सेगमेंट के खत्म होने का समय (अलग से उपलब्ध).
PlaceCitation
जगह के उद्धरण का एनोटेशन.
कोई विवरण नहीं दिया गया.
इसे हमेशा "place_citation" पर सेट किया जाता है.
जगह का आईडी, `places/{place_id}` फ़ॉर्मैट में होता है.
जगह का टाइटल.
जगह का यूआरआई रेफ़रंस.
review_snippets ReviewSnippet (ज़रूरी नहीं)
समीक्षाओं के ऐसे स्निपेट जिनका इस्तेमाल, Google Maps में किसी जगह की सुविधाओं के बारे में जवाब जनरेट करने के लिए किया जाता है.
फ़ील्ड
समीक्षा का टाइटल.
यह Google Maps पर मौजूद उपयोगकर्ता की समीक्षा से जुड़ा लिंक होता है.
समीक्षा स्निपेट का आईडी.
जवाब के उस सेगमेंट की शुरुआत जिसे इस सोर्स के लिए एट्रिब्यूट किया गया है. इंडेक्स से सेगमेंट की शुरुआत का पता चलता है. इसे बाइट में मापा जाता है.
एट्रिब्यूट किए गए सेगमेंट के खत्म होने का समय (अलग से उपलब्ध).
ImageContent
इमेज कॉन्टेंट ब्लॉक.
कोई विवरण नहीं दिया गया.
इसे हमेशा "image" पर सेट किया जाता है.
इमेज का कॉन्टेंट.
इमेज का यूआरआई.
इमेज का MIME टाइप.
ये वैल्यू हो सकती हैं:
-
image/png -
image/jpeg -
image/webp -
image/heic -
image/heif -
image/gif -
image/bmp -
image/tiff
resolution MediaResolution (ज़रूरी नहीं)
मीडिया का रिज़ॉल्यूशन.
ये वैल्यू हो सकती हैं:
-
low -
medium -
high -
ultra_high
AudioContent
ऑडियो कॉन्टेंट ब्लॉक.
कोई विवरण नहीं दिया गया.
इसे हमेशा "audio" पर सेट किया जाता है.
ऑडियो कॉन्टेंट.
ऑडियो का यूआरआई.
ऑडियो का MIME टाइप.
ये वैल्यू हो सकती हैं:
-
audio/wav -
audio/mp3 -
audio/aiff -
audio/aac -
audio/ogg -
audio/flac -
audio/mpeg -
audio/m4a -
audio/l16 -
audio/opus -
audio/alaw -
audio/mulaw
ऑडियो का सैंपल रेट.
ऑडियो चैनलों की संख्या.
DocumentContent
दस्तावेज़ के कॉन्टेंट का ब्लॉक.
कोई विवरण नहीं दिया गया.
इसे हमेशा "document" पर सेट किया जाता है.
दस्तावेज़ का कॉन्टेंट.
दस्तावेज़ का यूआरआई.
दस्तावेज़ का MIME टाइप.
ये वैल्यू हो सकती हैं:
-
application/pdf
VideoContent
वीडियो कॉन्टेंट ब्लॉक.
कोई विवरण नहीं दिया गया.
इसे हमेशा "video" पर सेट किया जाता है.
वीडियो कॉन्टेंट.
वीडियो का यूआरआई.
वीडियो का MIME टाइप.
ये वैल्यू हो सकती हैं:
-
video/mp4 -
video/mpeg -
video/mpg -
video/mov -
video/avi -
video/x-flv -
video/webm -
video/wmv -
video/3gpp
resolution MediaResolution (ज़रूरी नहीं)
मीडिया का रिज़ॉल्यूशन.
ये वैल्यू हो सकती हैं:
-
low -
medium -
high -
ultra_high
ThoughtContent
सोच से जुड़ा कॉन्टेंट ब्लॉक.
कोई विवरण नहीं दिया गया.
इसे हमेशा "thought" पर सेट किया जाता है.
बैकएंड सोर्स से मैच करने वाला सिग्नेचर, ताकि उसे जनरेशन में शामिल किया जा सके.
summary ThoughtSummaryContent (ज़रूरी नहीं)
जवाब की खास जानकारी.
संभावित टाइप
पॉलीमॉर्फ़िक डिसक्रिमिनेटर: type
TextContent
टेक्स्ट कॉन्टेंट वाला ब्लॉक.
कोई विवरण नहीं दिया गया.
इसे हमेशा "text" पर सेट किया जाता है.
ज़रूरी है. टेक्स्ट कॉन्टेंट.
annotations Annotation (ज़रूरी नहीं)
मॉडल से जनरेट किए गए कॉन्टेंट के लिए उद्धरण की जानकारी.
संभावित टाइप
पॉलीमॉर्फ़िक डिसक्रिमिनेटर: type
UrlCitation
यूआरएल उद्धरण एनोटेशन.
कोई विवरण नहीं दिया गया.
इसे हमेशा "url_citation" पर सेट किया जाता है.
यूआरएल.
यूआरएल का टाइटल.
जवाब के उस सेगमेंट की शुरुआत जिसे इस सोर्स के लिए एट्रिब्यूट किया गया है. इंडेक्स से सेगमेंट की शुरुआत का पता चलता है. इसे बाइट में मापा जाता है.
एट्रिब्यूट किए गए सेगमेंट के खत्म होने का समय (अलग से उपलब्ध).
FileCitation
फ़ाइल के उद्धरण का एनोटेशन.
कोई विवरण नहीं दिया गया.
इसे हमेशा "file_citation" पर सेट किया जाता है.
फ़ाइल का यूआरआई.
फ़ाइल का नाम.
टेक्स्ट के किसी हिस्से के लिए एट्रिब्यूट किया गया सोर्स.
जवाब के उस सेगमेंट की शुरुआत जिसे इस सोर्स के लिए एट्रिब्यूट किया गया है. इंडेक्स से सेगमेंट की शुरुआत का पता चलता है. इसे बाइट में मापा जाता है.
एट्रिब्यूट किए गए सेगमेंट के खत्म होने का समय (अलग से उपलब्ध).
PlaceCitation
जगह के उद्धरण का एनोटेशन.
कोई विवरण नहीं दिया गया.
इसे हमेशा "place_citation" पर सेट किया जाता है.
जगह का आईडी, `places/{place_id}` फ़ॉर्मैट में होता है.
जगह का टाइटल.
जगह का यूआरआई रेफ़रंस.
review_snippets ReviewSnippet (ज़रूरी नहीं)
समीक्षाओं के ऐसे स्निपेट जिनका इस्तेमाल, Google Maps में किसी जगह की सुविधाओं के बारे में जवाब जनरेट करने के लिए किया जाता है.
फ़ील्ड
समीक्षा का टाइटल.
यह Google Maps पर मौजूद उपयोगकर्ता की समीक्षा से जुड़ा लिंक होता है.
समीक्षा स्निपेट का आईडी.
जवाब के उस सेगमेंट की शुरुआत जिसे इस सोर्स के लिए एट्रिब्यूट किया गया है. इंडेक्स से सेगमेंट की शुरुआत का पता चलता है. इसे बाइट में मापा जाता है.
एट्रिब्यूट किए गए सेगमेंट के खत्म होने का समय (अलग से उपलब्ध).
ImageContent
इमेज कॉन्टेंट ब्लॉक.
कोई विवरण नहीं दिया गया.
इसे हमेशा "image" पर सेट किया जाता है.
इमेज का कॉन्टेंट.
इमेज का यूआरआई.
इमेज का MIME टाइप.
ये वैल्यू हो सकती हैं:
-
image/png -
image/jpeg -
image/webp -
image/heic -
image/heif -
image/gif -
image/bmp -
image/tiff
resolution MediaResolution (ज़रूरी नहीं)
मीडिया का रिज़ॉल्यूशन.
ये वैल्यू हो सकती हैं:
-
low -
medium -
high -
ultra_high
FunctionCallContent
फ़ंक्शन टूल कॉल का कॉन्टेंट ब्लॉक.
कोई विवरण नहीं दिया गया.
इसे हमेशा "function_call" पर सेट किया जाता है.
ज़रूरी है. कॉल किए जाने वाले टूल का नाम.
ज़रूरी है. फ़ंक्शन में पास किए जाने वाले आर्ग्युमेंट.
ज़रूरी है. इस टूल कॉल के लिए यूनीक आईडी.
बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.
CodeExecutionCallContent
कोड को चलाने से जुड़ा कॉन्टेंट.
कोई विवरण नहीं दिया गया.
इसे हमेशा "code_execution_call" पर सेट किया जाता है.
arguments CodeExecutionCallArguments (ज़रूरी है)
ज़रूरी है. कोड को एक्ज़ीक्यूट करने के लिए पास किए जाने वाले आर्ग्युमेंट.
फ़ील्ड
`code` की प्रोग्रामिंग भाषा.
ये वैल्यू हो सकती हैं:
-
python
लागू किया जाने वाला कोड.
ज़रूरी है. इस टूल कॉल के लिए यूनीक आईडी.
बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.
UrlContextCallContent
यूआरएल के कॉन्टेक्स्ट का कॉन्टेंट.
कोई विवरण नहीं दिया गया.
इसे हमेशा "url_context_call" पर सेट किया जाता है.
arguments UrlContextCallArguments (ज़रूरी है)
ज़रूरी है. यूआरएल के कॉन्टेक्स्ट में पास किए जाने वाले आर्ग्युमेंट.
फ़ील्ड
फ़ेच किए जाने वाले यूआरएल.
ज़रूरी है. इस टूल कॉल के लिए यूनीक आईडी.
बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.
McpServerToolCallContent
MCPServer टूल कॉल का कॉन्टेंट.
कोई विवरण नहीं दिया गया.
इसे हमेशा "mcp_server_tool_call" पर सेट किया जाता है.
ज़रूरी है. कॉल किए गए टूल का नाम.
ज़रूरी है. इस्तेमाल किए गए एमसीपी सर्वर का नाम.
ज़रूरी है. फ़ंक्शन के लिए आर्ग्युमेंट का JSON ऑब्जेक्ट.
ज़रूरी है. इस टूल कॉल के लिए यूनीक आईडी.
बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.
GoogleSearchCallContent
Google Search का कॉन्टेंट.
कोई विवरण नहीं दिया गया.
इसे हमेशा "google_search_call" पर सेट किया जाता है.
arguments GoogleSearchCallArguments (ज़रूरी है)
ज़रूरी है. Google Search को पास किए जाने वाले आर्ग्युमेंट.
फ़ील्ड
वेब खोज से जुड़ी क्वेरी, ताकि वेब खोज को फ़ॉलो अप किया जा सके.
खोज के लिए इस्तेमाल किए गए डेटा का टाइप.
ये वैल्यू हो सकती हैं:
-
web_search -
image_search -
enterprise_web_search
ज़रूरी है. इस टूल कॉल के लिए यूनीक आईडी.
बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.
FileSearchCallContent
फ़ाइल में मौजूद कॉन्टेंट को खोजने की सुविधा.
कोई विवरण नहीं दिया गया.
इसे हमेशा "file_search_call" पर सेट किया जाता है.
ज़रूरी है. इस टूल कॉल के लिए यूनीक आईडी.
बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.
GoogleMapsCallContent
Google Maps का कॉन्टेंट.
कोई विवरण नहीं दिया गया.
इसे हमेशा "google_maps_call" पर सेट किया जाता है.
arguments GoogleMapsCallArguments (ज़रूरी नहीं)
Google Maps टूल को पास किए जाने वाले तर्क.
फ़ील्ड
वे क्वेरी जिन्हें एक्ज़ीक्यूट करना है.
ज़रूरी है. इस टूल कॉल के लिए यूनीक आईडी.
बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.
FunctionResultContent
फ़ंक्शन टूल के नतीजे का कॉन्टेंट ब्लॉक.
कोई विवरण नहीं दिया गया.
इसे हमेशा "function_result" पर सेट किया जाता है.
कॉल किए गए टूल का नाम.
टूल कॉल में कोई गड़बड़ी हुई है या नहीं.
ज़रूरी है. यह आईडी, फ़ंक्शन कॉल ब्लॉक के आईडी से मेल खाना चाहिए.
बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.
टूल कॉल का नतीजा.
CodeExecutionResultContent
कोड चलाने के नतीजे का कॉन्टेंट.
कोई विवरण नहीं दिया गया.
इसे हमेशा "code_execution_result" पर सेट किया जाता है.
ज़रूरी है. कोड को चलाने का आउटपुट.
कोड चलाने पर कोई गड़बड़ी हुई है या नहीं.
ज़रूरी है. यह आईडी, फ़ंक्शन कॉल ब्लॉक के आईडी से मेल खाना चाहिए.
बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.
UrlContextResultContent
यूआरएल के कॉन्टेक्स्ट के हिसाब से मिले नतीजे का कॉन्टेंट.
कोई विवरण नहीं दिया गया.
इसे हमेशा "url_context_result" पर सेट किया जाता है.
result UrlContextResult (ज़रूरी है)
ज़रूरी है. यूआरएल के कॉन्टेक्स्ट के नतीजे.
फ़ील्ड
फ़ेच किया गया यूआरएल.
यूआरएल को फिर से पाने का स्टेटस.
ये वैल्यू हो सकती हैं:
-
success -
error -
paywall -
unsafe
इससे पता चलता है कि यूआरएल के कॉन्टेक्स्ट में कोई गड़बड़ी हुई है या नहीं.
ज़रूरी है. यह आईडी, फ़ंक्शन कॉल ब्लॉक के आईडी से मेल खाना चाहिए.
बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.
GoogleSearchResultContent
Google Search के नतीजों में दिखने वाला कॉन्टेंट.
कोई विवरण नहीं दिया गया.
इसे हमेशा "google_search_result" पर सेट किया जाता है.
result GoogleSearchResult (ज़रूरी है)
ज़रूरी है. Google Search के नतीजे.
फ़ील्ड
यह वेब कॉन्टेंट स्निपेट होता है. इसे किसी वेब पेज या ऐप्लिकेशन के वेबव्यू में एम्बेड किया जा सकता है.
इससे पता चलता है कि Google Search में कोई गड़बड़ी हुई है या नहीं.
ज़रूरी है. यह आईडी, फ़ंक्शन कॉल ब्लॉक के आईडी से मेल खाना चाहिए.
बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.
McpServerToolResultContent
MCPServer टूल के नतीजे का कॉन्टेंट.
कोई विवरण नहीं दिया गया.
इसे हमेशा "mcp_server_tool_result" पर सेट किया जाता है.
उस टूल का नाम जिसे इस टूल कॉल के लिए कॉल किया गया है.
इस्तेमाल किए गए एमसीपी सर्वर का नाम.
ज़रूरी है. यह आईडी, फ़ंक्शन कॉल ब्लॉक के आईडी से मेल खाना चाहिए.
बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.
एमसीपी सर्वर कॉल का आउटपुट. यह सामान्य टेक्स्ट या रिच कॉन्टेंट हो सकता है.
FileSearchResultContent
फ़ाइल खोजने के नतीजे का कॉन्टेंट.
कोई विवरण नहीं दिया गया.
इसे हमेशा "file_search_result" पर सेट किया जाता है.
result FileSearchResult (ज़रूरी है)
ज़रूरी है. फ़ाइल खोजने के नतीजे.
फ़ील्ड
उपयोगकर्ता ने FileSearchResult के बारे में मेटाडेटा दिया है.
ज़रूरी है. यह आईडी, फ़ंक्शन कॉल ब्लॉक के आईडी से मेल खाना चाहिए.
बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.
GoogleMapsResultContent
Google Maps पर खोज के नतीजों में दिखने वाला कॉन्टेंट.
कोई विवरण नहीं दिया गया.
इसे हमेशा "google_maps_result" पर सेट किया जाता है.
result GoogleMapsResult (ज़रूरी है)
ज़रूरी है. Google Maps पर मिले नतीजे.
फ़ील्ड
places Places (ज़रूरी नहीं)
वे जगहें जो मिलीं.
फ़ील्ड
जगह का आईडी, `places/{place_id}` फ़ॉर्मैट में होता है.
जगह का टाइटल.
जगह का यूआरआई रेफ़रंस.
review_snippets ReviewSnippet (ज़रूरी नहीं)
समीक्षाओं के ऐसे स्निपेट जिनका इस्तेमाल, Google Maps में किसी जगह की सुविधाओं के बारे में जवाब जनरेट करने के लिए किया जाता है.
फ़ील्ड
समीक्षा का टाइटल.
यह Google Maps पर मौजूद उपयोगकर्ता की समीक्षा से जुड़ा लिंक होता है.
समीक्षा स्निपेट का आईडी.
Google Maps विजेट के कॉन्टेक्स्ट टोकन का संसाधन नाम.
ज़रूरी है. यह आईडी, फ़ंक्शन कॉल ब्लॉक के आईडी से मेल खाना चाहिए.
बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.
उदाहरण
टेक्स्ट
{ "type": "text", "text": "Hello, how are you?" }
इमेज
{ "type": "image", "data": "BASE64_ENCODED_IMAGE", "mime_type": "image/png" }
ऑडियो
{ "type": "audio", "data": "BASE64_ENCODED_AUDIO", "mime_type": "audio/wav" }
दस्तावेज़
{ "type": "document", "data": "BASE64_ENCODED_DOCUMENT", "mime_type": "application/pdf" }
वीडियो
{ "type": "video", "uri": "https://www.youtube.com/watch?v=9hE5-98ZeCg" }
सोच-विचार
{ "type": "thought", "summary": [ { "type": "text", "text": "The user is asking about the weather. I should use the get_weather tool." } ], "signature": "CoMDAXLI2nynRYojJIy6B1Jh9os2crpWLfB0+19xcLsGG46bd8wjkF/6RNlRUdvHrXyjsHkG0BZFcuO/bPOyA6Xh5jANNgx82wPHjGExN8A4ZQn56FlMwyZoqFVQz0QyY1lfibFJ2zU3J87uw26OewzcuVX0KEcs+GIsZa3EA6WwqhbsOd3wtZB3Ua2Qf98VAWZTS5y/tWpql7jnU3/CU7pouxQr/Bwft3hwnJNesQ9/dDJTuaQ8Zprh9VRWf1aFFjpIueOjBRrlT3oW6/y/eRl/Gt9BQXCYTqg/38vHFUU4Wo/d9dUpvfCe/a3o97t2Jgxp34oFKcsVb4S5WJrykIkw+14DzVnTpCpbQNFckqvFLuqnJCkL0EQFtunBXI03FJpPu3T1XU6id8S7ojoJQZSauGUCgmaLqUGdMrd08oo81ecoJSLs51Re9N/lISGmjWFPGpqJLoGq6uo4FHz58hmeyXCgHG742BHz2P3MiH1CXHUT2J8mF6zLhf3SR9Qb3lkrobAh" }
फ़ंक्शन कॉल
{ "type": "function_call", "name": "get_weather", "id": "gth23981", "arguments": { "location": "Boston, MA" } }
कोड चलाने के लिए कॉल करना
{ "type": "code_execution_call", "id": "call_123456", "arguments": { "language": "python", "code": "print('hello world')" } }
यूआरएल कॉन्टेक्स्ट कॉल
{ "type": "url_context_call", "id": "call_123456", "arguments": { "urls": [ "https://www.example.com" ] } }
Mcp Server Tool Call
{ "type": "mcp_server_tool_call", "id": "call_123456", "name": "get_forecast", "server_name": "weather_server", "arguments": { "city": "London" } }
Google Search Call
{ "type": "google_search_call", "id": "call_123456", "arguments": { "queries": [ "weather in Boston" ] } }
फ़ाइल खोजने के लिए कॉल करें
{ "type": "file_search_call", "id": "call_123456" }
Google Maps Call
{ "type": "google_maps_call", "id": "call_123456", "arguments": { "query": "best food near me" } }
फ़ंक्शन का नतीजा
{ "type": "function_result", "name": "get_weather", "call_id": "gth23981", "result": [ { "type": "text", "text": "{\"weather\":\"sunny\"}" } ] }
कोड चलाने का नतीजा
{ "type": "code_execution_result", "call_id": "call_123456", "result": "hello world" }
यूआरएल के कॉन्टेक्स्ट के हिसाब से मिले नतीजे
{ "type": "url_context_result", "call_id": "call_123456", "result": [ { "url": "https://www.example.com", "status": "SUCCESS" } ] }
Google पर खोज नतीजा
{ "type": "google_search_result", "call_id": "call_123456", "result": [ { "url": "https://www.google.com/search?q=weather+in+Boston", "title": "Weather in Boston" } ] }
Mcp Server Tool Result
{ "type": "mcp_server_tool_result", "name": "get_forecast", "server_name": "weather_server", "call_id": "call_123456", "result": "sunny" }
फ़ाइल खोजने का नतीजा
{ "type": "file_search_result", "call_id": "call_123456", "result": [ { "text": "search result chunk", "file_search_store": "file_search_store" } ] }
Google Maps पर दिखने वाले नतीजे
{ "type": "google_maps_result", "call_id": "call_123456", "result": [ { "places": [ { "url": "https://www.google.com/maps/search/best+food+near+me", "name": "Tasty Restaurant" } ] } ] }
टूल
ऐसा टूल जिसका इस्तेमाल मॉडल कर सकता है.
संभावित टाइप
पॉलीमॉर्फ़िक डिसक्रिमिनेटर: type
सुविधा
ऐसा टूल जिसका इस्तेमाल मॉडल कर सकता है.
कोई विवरण नहीं दिया गया.
इसे हमेशा "function" पर सेट किया जाता है.
फ़ंक्शन का नाम.
फ़ंक्शन के बारे में जानकारी.
फ़ंक्शन के पैरामीटर के लिए JSON स्कीमा.
CodeExecution
यह एक ऐसा टूल है जिसका इस्तेमाल मॉडल, कोड को लागू करने के लिए कर सकता है.
कोई विवरण नहीं दिया गया.
इसे हमेशा "code_execution" पर सेट किया जाता है.
UrlContext
यह एक ऐसा टूल है जिसका इस्तेमाल मॉडल, यूआरएल के कॉन्टेक्स्ट को फ़ेच करने के लिए कर सकता है.
कोई विवरण नहीं दिया गया.
इसे हमेशा "url_context" पर सेट किया जाता है.
ComputerUse
यह एक ऐसा टूल है जिसका इस्तेमाल मॉडल, कंप्यूटर से इंटरैक्ट करने के लिए कर सकता है.
कोई विवरण नहीं दिया गया.
इसे हमेशा "computer_use" पर सेट किया जाता है.
जिस एनवायरमेंट में कार्रवाई की जा रही है.
ये वैल्यू हो सकती हैं:
-
browser
पहले से तय किए गए फ़ंक्शन की सूची, जिन्हें मॉडल कॉल से बाहर रखा गया है.
McpServer
MCPServer एक ऐसा सर्वर होता है जिसे मॉडल, कार्रवाइयां करने के लिए कॉल कर सकता है.
कोई विवरण नहीं दिया गया.
इसे हमेशा "mcp_server" पर सेट किया जाता है.
MCPServer का नाम.
MCPServer एंडपॉइंट का पूरा यूआरएल. उदाहरण: "https://api.example.com/mcp"
ज़रूरी नहीं: अगर ज़रूरी हो, तो पुष्टि करने वाले हेडर, टाइमआउट वगैरह के लिए फ़ील्ड.
allowed_tools AllowedTools (ज़रूरी नहीं)
अनुमति वाले टूल.
फ़ील्ड
mode ToolChoiceType (ज़रूरी नहीं)
टूल चुनने का मोड.
ये वैल्यू हो सकती हैं:
-
auto -
any -
none -
validated
उन टूल के नाम जिन्हें इस्तेमाल करने की अनुमति है.
GoogleSearch
यह एक ऐसा टूल है जिसका इस्तेमाल मॉडल, Google पर खोजने के लिए कर सकता है.
कोई विवरण नहीं दिया गया.
इसे हमेशा "google_search" पर सेट किया जाता है.
सर्च के आधार पर जवाब देने की सुविधा के टाइप चालू करने के लिए.
ये वैल्यू हो सकती हैं:
-
web_search -
image_search -
enterprise_web_search
FileSearch
यह एक ऐसा टूल है जिसका इस्तेमाल मॉडल, फ़ाइलें खोजने के लिए कर सकता है.
कोई विवरण नहीं दिया गया.
इसे हमेशा "file_search" पर सेट किया जाता है.
फ़ाइल में, खोजने के लिए स्टोर के नाम मौजूद होते हैं.
सेमैंटिक तरीके से खोजे गए कितने चंक वापस पाने हैं.
सिमैंटिक तौर पर जानकारी पाने के लिए इस्तेमाल किए जाने वाले दस्तावेज़ों और चंक पर लागू करने के लिए मेटाडेटा फ़िल्टर.
GoogleMaps
यह एक ऐसा टूल है जिसका इस्तेमाल मॉडल, Google Maps को कॉल करने के लिए कर सकता है.
कोई विवरण नहीं दिया गया.
इसे हमेशा "google_maps" पर सेट किया जाता है.
यह तय करता है कि जवाब के टूल कॉल के नतीजे में, विजेट कॉन्टेक्स्ट टोकन दिखाना है या नहीं.
उपयोगकर्ता की जगह का अक्षांश.
उपयोगकर्ता की जगह का देशांतर.
जानकारी पाना
यह एक ऐसा टूल है जिसका इस्तेमाल मॉडल, फ़ाइलों को वापस पाने के लिए कर सकता है.
कोई विवरण नहीं दिया गया.
इसे हमेशा "retrieval" पर सेट किया जाता है.
फ़ाइल वापस पाने की सुविधा चालू करने के लिए, फ़ाइल वापस पाने के तरीके.
ये वैल्यू हो सकती हैं:
-
vertex_ai_search
vertex_ai_search_config VertexAISearchConfig (optional)
इस कुकी का इस्तेमाल, VertexAISearch के कॉन्फ़िगरेशन के बारे में बताने के लिए किया जाता है.
फ़ील्ड
ज़रूरी नहीं. इस कुकी का इस्तेमाल, Vertex AI Search इंजन के बारे में बताने के लिए किया जाता है.
ज़रूरी नहीं. इस कुकी का इस्तेमाल, Vertex AI Search के डेटास्टोर के बारे में बताने के लिए किया जाता है.
उदाहरण
फ़ंक्शन
CodeExecution
UrlContext
ComputerUse
McpServer
GoogleSearch
FileSearch
GoogleMaps
डेटा वापस पाना
इस तरह के अनुरोध का कोई उदाहरण नहीं है.
Turn
फ़ील्ड
इस टर्न को शुरू करने वाला. इनपुट के लिए उपयोगकर्ता या मॉडल आउटपुट के लिए मॉडल होना चाहिए.
कोई विवरण नहीं दिया गया.
उदाहरण
उपयोगकर्ता की बारी
{ "role": "user", "content": [ { "type": "text", "text": "user turn" } ] }
मॉडल टर्न
{ "role": "model", "content": [ { "type": "text", "text": "model turn" } ] }
InteractionSseEvent
संभावित टाइप
पॉलीमॉर्फ़िक डिसक्रिमिनेटर: event_type
InteractionStartEvent
कोई विवरण नहीं दिया गया.
इसे हमेशा "interaction.start" पर सेट किया जाता है.
कोई विवरण नहीं दिया गया.
इस इवेंट से इंटरैक्शन स्ट्रीम को फिर से शुरू करने के लिए, event_id टोकन का इस्तेमाल किया जाएगा.
InteractionCompleteEvent
कोई विवरण नहीं दिया गया.
इसे हमेशा "interaction.complete" पर सेट किया जाता है.
ज़रूरी है. पेलोड का साइज़ कम करने के लिए, खाली आउटपुट के साथ इंटरैक्शन पूरा किया गया. असली आउटपुट के लिए, ContentDelta इवेंट का इस्तेमाल करें.
इस इवेंट से इंटरैक्शन स्ट्रीम को फिर से शुरू करने के लिए, event_id टोकन का इस्तेमाल किया जाएगा.
InteractionStatusUpdate
कोई विवरण नहीं दिया गया.
इसे हमेशा "interaction.status_update" पर सेट किया जाता है.
कोई विवरण नहीं दिया गया.
कोई विवरण नहीं दिया गया.
ये वैल्यू हो सकती हैं:
-
in_progress -
requires_action -
completed -
failed -
cancelled -
incomplete
इस इवेंट से इंटरैक्शन स्ट्रीम को फिर से शुरू करने के लिए, event_id टोकन का इस्तेमाल किया जाएगा.
ContentStart
कोई विवरण नहीं दिया गया.
इसे हमेशा "content.start" पर सेट किया जाता है.
कोई विवरण नहीं दिया गया.
कोई विवरण नहीं दिया गया.
इस इवेंट से इंटरैक्शन स्ट्रीम को फिर से शुरू करने के लिए, event_id टोकन का इस्तेमाल किया जाएगा.
ContentDelta
कोई विवरण नहीं दिया गया.
इसे हमेशा "content.delta" पर सेट किया जाता है.
कोई विवरण नहीं दिया गया.
delta ContentDeltaData (ज़रूरी है)
कोई विवरण नहीं दिया गया.
संभावित टाइप
पॉलीमॉर्फ़िक डिसक्रिमिनेटर: type
TextDelta
कोई विवरण नहीं दिया गया.
इसे हमेशा "text" पर सेट किया जाता है.
कोई विवरण नहीं दिया गया.
ImageDelta
कोई विवरण नहीं दिया गया.
इसे हमेशा "image" पर सेट किया जाता है.
कोई विवरण नहीं दिया गया.
कोई विवरण नहीं दिया गया.
कोई विवरण नहीं दिया गया.
ये वैल्यू हो सकती हैं:
-
image/png -
image/jpeg -
image/webp -
image/heic -
image/heif -
image/gif -
image/bmp -
image/tiff
resolution MediaResolution (ज़रूरी नहीं)
मीडिया का रिज़ॉल्यूशन.
ये वैल्यू हो सकती हैं:
-
low -
medium -
high -
ultra_high
AudioDelta
कोई विवरण नहीं दिया गया.
इसे हमेशा "audio" पर सेट किया जाता है.
कोई विवरण नहीं दिया गया.
कोई विवरण नहीं दिया गया.
कोई विवरण नहीं दिया गया.
ये वैल्यू हो सकती हैं:
-
audio/wav -
audio/mp3 -
audio/aiff -
audio/aac -
audio/ogg -
audio/flac -
audio/mpeg -
audio/m4a -
audio/l16 -
audio/opus -
audio/alaw -
audio/mulaw
ऑडियो का सैंपल रेट.
ऑडियो चैनलों की संख्या.
DocumentDelta
कोई विवरण नहीं दिया गया.
इसे हमेशा "document" पर सेट किया जाता है.
कोई विवरण नहीं दिया गया.
कोई विवरण नहीं दिया गया.
कोई विवरण नहीं दिया गया.
ये वैल्यू हो सकती हैं:
-
application/pdf
VideoDelta
कोई विवरण नहीं दिया गया.
इसे हमेशा "video" पर सेट किया जाता है.
कोई विवरण नहीं दिया गया.
कोई विवरण नहीं दिया गया.
कोई विवरण नहीं दिया गया.
ये वैल्यू हो सकती हैं:
-
video/mp4 -
video/mpeg -
video/mpg -
video/mov -
video/avi -
video/x-flv -
video/webm -
video/wmv -
video/3gpp
resolution MediaResolution (ज़रूरी नहीं)
मीडिया का रिज़ॉल्यूशन.
ये वैल्यू हो सकती हैं:
-
low -
medium -
high -
ultra_high
ThoughtSummaryDelta
कोई विवरण नहीं दिया गया.
इसे हमेशा "thought_summary" पर सेट किया जाता है.
content ThoughtSummaryContent (ज़रूरी नहीं)
विचार में जोड़ने के लिए नई खास जानकारी वाला आइटम.
संभावित टाइप
पॉलीमॉर्फ़िक डिसक्रिमिनेटर: type
TextContent
टेक्स्ट कॉन्टेंट वाला ब्लॉक.
कोई विवरण नहीं दिया गया.
इसे हमेशा "text" पर सेट किया जाता है.
ज़रूरी है. टेक्स्ट कॉन्टेंट.
annotations Annotation (ज़रूरी नहीं)
मॉडल से जनरेट किए गए कॉन्टेंट के लिए उद्धरण की जानकारी.
संभावित टाइप
पॉलीमॉर्फ़िक डिसक्रिमिनेटर: type
UrlCitation
यूआरएल उद्धरण एनोटेशन.
कोई विवरण नहीं दिया गया.
इसे हमेशा "url_citation" पर सेट किया जाता है.
यूआरएल.
यूआरएल का टाइटल.
जवाब के उस सेगमेंट की शुरुआत जिसे इस सोर्स के लिए एट्रिब्यूट किया गया है. इंडेक्स से सेगमेंट की शुरुआत का पता चलता है. इसे बाइट में मापा जाता है.
एट्रिब्यूट किए गए सेगमेंट के खत्म होने का समय (अलग से उपलब्ध).
FileCitation
फ़ाइल के उद्धरण का एनोटेशन.
कोई विवरण नहीं दिया गया.
इसे हमेशा "file_citation" पर सेट किया जाता है.
फ़ाइल का यूआरआई.
फ़ाइल का नाम.
टेक्स्ट के किसी हिस्से के लिए एट्रिब्यूट किया गया सोर्स.
जवाब के उस सेगमेंट की शुरुआत जिसे इस सोर्स के लिए एट्रिब्यूट किया गया है. इंडेक्स से सेगमेंट की शुरुआत का पता चलता है. इसे बाइट में मापा जाता है.
एट्रिब्यूट किए गए सेगमेंट के खत्म होने का समय (अलग से उपलब्ध).
PlaceCitation
जगह के उद्धरण का एनोटेशन.
कोई विवरण नहीं दिया गया.
इसे हमेशा "place_citation" पर सेट किया जाता है.
जगह का आईडी, `places/{place_id}` फ़ॉर्मैट में होता है.
जगह का टाइटल.
जगह का यूआरआई रेफ़रंस.
review_snippets ReviewSnippet (ज़रूरी नहीं)
समीक्षाओं के ऐसे स्निपेट जिनका इस्तेमाल, Google Maps में किसी जगह की सुविधाओं के बारे में जवाब जनरेट करने के लिए किया जाता है.
फ़ील्ड
समीक्षा का टाइटल.
यह Google Maps पर मौजूद उपयोगकर्ता की समीक्षा से जुड़ा लिंक होता है.
समीक्षा स्निपेट का आईडी.
जवाब के उस सेगमेंट की शुरुआत जिसे इस सोर्स के लिए एट्रिब्यूट किया गया है. इंडेक्स से सेगमेंट की शुरुआत का पता चलता है. इसे बाइट में मापा जाता है.
एट्रिब्यूट किए गए सेगमेंट के खत्म होने का समय (अलग से उपलब्ध).
ImageContent
इमेज कॉन्टेंट ब्लॉक.
कोई विवरण नहीं दिया गया.
इसे हमेशा "image" पर सेट किया जाता है.
इमेज का कॉन्टेंट.
इमेज का यूआरआई.
इमेज का MIME टाइप.
ये वैल्यू हो सकती हैं:
-
image/png -
image/jpeg -
image/webp -
image/heic -
image/heif -
image/gif -
image/bmp -
image/tiff
resolution MediaResolution (ज़रूरी नहीं)
मीडिया का रिज़ॉल्यूशन.
ये वैल्यू हो सकती हैं:
-
low -
medium -
high -
ultra_high
ThoughtSignatureDelta
कोई विवरण नहीं दिया गया.
इसे हमेशा "thought_signature" पर सेट किया जाता है.
बैकएंड सोर्स से मैच करने वाला सिग्नेचर, ताकि उसे जनरेशन में शामिल किया जा सके.
FunctionCallDelta
कोई विवरण नहीं दिया गया.
इसे हमेशा "function_call" पर सेट किया जाता है.
कोई विवरण नहीं दिया गया.
कोई विवरण नहीं दिया गया.
ज़रूरी है. इस टूल कॉल के लिए यूनीक आईडी.
बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.
CodeExecutionCallDelta
कोई विवरण नहीं दिया गया.
इसे हमेशा "code_execution_call" पर सेट किया जाता है.
arguments CodeExecutionCallArguments (ज़रूरी है)
कोई विवरण नहीं दिया गया.
फ़ील्ड
`code` की प्रोग्रामिंग भाषा.
ये वैल्यू हो सकती हैं:
-
python
लागू किया जाने वाला कोड.
ज़रूरी है. इस टूल कॉल के लिए यूनीक आईडी.
बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.
UrlContextCallDelta
कोई विवरण नहीं दिया गया.
इसे हमेशा "url_context_call" पर सेट किया जाता है.
arguments UrlContextCallArguments (ज़रूरी है)
कोई विवरण नहीं दिया गया.
फ़ील्ड
फ़ेच किए जाने वाले यूआरएल.
ज़रूरी है. इस टूल कॉल के लिए यूनीक आईडी.
बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.
GoogleSearchCallDelta
कोई विवरण नहीं दिया गया.
इसे हमेशा "google_search_call" पर सेट किया जाता है.
arguments GoogleSearchCallArguments (ज़रूरी है)
कोई विवरण नहीं दिया गया.
फ़ील्ड
वेब खोज से जुड़ी क्वेरी, ताकि वेब खोज को फ़ॉलो अप किया जा सके.
ज़रूरी है. इस टूल कॉल के लिए यूनीक आईडी.
बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.
McpServerToolCallDelta
कोई विवरण नहीं दिया गया.
इसे हमेशा "mcp_server_tool_call" पर सेट किया जाता है.
कोई विवरण नहीं दिया गया.
कोई विवरण नहीं दिया गया.
कोई विवरण नहीं दिया गया.
ज़रूरी है. इस टूल कॉल के लिए यूनीक आईडी.
बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.
FileSearchCallDelta
कोई विवरण नहीं दिया गया.
इसे हमेशा "file_search_call" पर सेट किया जाता है.
ज़रूरी है. इस टूल कॉल के लिए यूनीक आईडी.
बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.
GoogleMapsCallDelta
कोई विवरण नहीं दिया गया.
इसे हमेशा "google_maps_call" पर सेट किया जाता है.
arguments GoogleMapsCallArguments (ज़रूरी नहीं)
Google Maps टूल को पास किए जाने वाले तर्क.
फ़ील्ड
वे क्वेरी जिन्हें एक्ज़ीक्यूट करना है.
ज़रूरी है. इस टूल कॉल के लिए यूनीक आईडी.
बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.
FunctionResultDelta
कोई विवरण नहीं दिया गया.
इसे हमेशा "function_result" पर सेट किया जाता है.
कोई विवरण नहीं दिया गया.
कोई विवरण नहीं दिया गया.
ज़रूरी है. यह आईडी, फ़ंक्शन कॉल ब्लॉक के आईडी से मेल खाना चाहिए.
बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.
कोई विवरण नहीं दिया गया.
CodeExecutionResultDelta
कोई विवरण नहीं दिया गया.
इसे हमेशा "code_execution_result" पर सेट किया जाता है.
कोई विवरण नहीं दिया गया.
कोई विवरण नहीं दिया गया.
ज़रूरी है. यह आईडी, फ़ंक्शन कॉल ब्लॉक के आईडी से मेल खाना चाहिए.
बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.
UrlContextResultDelta
कोई विवरण नहीं दिया गया.
इसे हमेशा "url_context_result" पर सेट किया जाता है.
result UrlContextResult (ज़रूरी है)
कोई विवरण नहीं दिया गया.
फ़ील्ड
फ़ेच किया गया यूआरएल.
यूआरएल को फिर से पाने का स्टेटस.
ये वैल्यू हो सकती हैं:
-
success -
error -
paywall -
unsafe
कोई विवरण नहीं दिया गया.
ज़रूरी है. यह आईडी, फ़ंक्शन कॉल ब्लॉक के आईडी से मेल खाना चाहिए.
बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.
GoogleSearchResultDelta
कोई विवरण नहीं दिया गया.
इसे हमेशा "google_search_result" पर सेट किया जाता है.
result GoogleSearchResult (ज़रूरी है)
कोई विवरण नहीं दिया गया.
फ़ील्ड
यह वेब कॉन्टेंट स्निपेट होता है. इसे किसी वेब पेज या ऐप्लिकेशन के वेबव्यू में एम्बेड किया जा सकता है.
कोई विवरण नहीं दिया गया.
ज़रूरी है. यह आईडी, फ़ंक्शन कॉल ब्लॉक के आईडी से मेल खाना चाहिए.
बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.
McpServerToolResultDelta
कोई विवरण नहीं दिया गया.
इसे हमेशा "mcp_server_tool_result" पर सेट किया जाता है.
कोई विवरण नहीं दिया गया.
कोई विवरण नहीं दिया गया.
ज़रूरी है. यह आईडी, फ़ंक्शन कॉल ब्लॉक के आईडी से मेल खाना चाहिए.
बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.
कोई विवरण नहीं दिया गया.
FileSearchResultDelta
कोई विवरण नहीं दिया गया.
इसे हमेशा "file_search_result" पर सेट किया जाता है.
result FileSearchResult (ज़रूरी है)
कोई विवरण नहीं दिया गया.
फ़ील्ड
उपयोगकर्ता ने FileSearchResult के बारे में मेटाडेटा दिया है.
ज़रूरी है. यह आईडी, फ़ंक्शन कॉल ब्लॉक के आईडी से मेल खाना चाहिए.
बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.
GoogleMapsResultDelta
कोई विवरण नहीं दिया गया.
इसे हमेशा "google_maps_result" पर सेट किया जाता है.
result GoogleMapsResult (ज़रूरी नहीं)
Google Maps पर मिले नतीजे.
फ़ील्ड
places Places (ज़रूरी नहीं)
वे जगहें जो मिलीं.
फ़ील्ड
जगह का आईडी, `places/{place_id}` फ़ॉर्मैट में होता है.
जगह का टाइटल.
जगह का यूआरआई रेफ़रंस.
review_snippets ReviewSnippet (ज़रूरी नहीं)
समीक्षाओं के ऐसे स्निपेट जिनका इस्तेमाल, Google Maps में किसी जगह की सुविधाओं के बारे में जवाब जनरेट करने के लिए किया जाता है.
फ़ील्ड
समीक्षा का टाइटल.
यह Google Maps पर मौजूद उपयोगकर्ता की समीक्षा से जुड़ा लिंक होता है.
समीक्षा स्निपेट का आईडी.
Google Maps विजेट के कॉन्टेक्स्ट टोकन का संसाधन नाम.
ज़रूरी है. यह आईडी, फ़ंक्शन कॉल ब्लॉक के आईडी से मेल खाना चाहिए.
बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.
TextAnnotationDelta
कोई विवरण नहीं दिया गया.
इसे हमेशा "text_annotation" पर सेट किया जाता है.
annotations Annotation (ज़रूरी नहीं)
मॉडल से जनरेट किए गए कॉन्टेंट के लिए उद्धरण की जानकारी.
संभावित टाइप
पॉलीमॉर्फ़िक डिसक्रिमिनेटर: type
UrlCitation
यूआरएल उद्धरण एनोटेशन.
कोई विवरण नहीं दिया गया.
इसे हमेशा "url_citation" पर सेट किया जाता है.
यूआरएल.
यूआरएल का टाइटल.
जवाब के उस सेगमेंट की शुरुआत जिसे इस सोर्स के लिए एट्रिब्यूट किया गया है. इंडेक्स से सेगमेंट की शुरुआत का पता चलता है. इसे बाइट में मापा जाता है.
एट्रिब्यूट किए गए सेगमेंट के खत्म होने का समय (अलग से उपलब्ध).
FileCitation
फ़ाइल के उद्धरण का एनोटेशन.
कोई विवरण नहीं दिया गया.
इसे हमेशा "file_citation" पर सेट किया जाता है.
फ़ाइल का यूआरआई.
फ़ाइल का नाम.
टेक्स्ट के किसी हिस्से के लिए एट्रिब्यूट किया गया सोर्स.
जवाब के उस सेगमेंट की शुरुआत जिसे इस सोर्स के लिए एट्रिब्यूट किया गया है. इंडेक्स से सेगमेंट की शुरुआत का पता चलता है. इसे बाइट में मापा जाता है.
एट्रिब्यूट किए गए सेगमेंट के खत्म होने का समय (अलग से उपलब्ध).
PlaceCitation
जगह के उद्धरण का एनोटेशन.
कोई विवरण नहीं दिया गया.
इसे हमेशा "place_citation" पर सेट किया जाता है.
जगह का आईडी, `places/{place_id}` फ़ॉर्मैट में होता है.
जगह का टाइटल.
जगह का यूआरआई रेफ़रंस.
review_snippets ReviewSnippet (ज़रूरी नहीं)
समीक्षाओं के ऐसे स्निपेट जिनका इस्तेमाल, Google Maps में किसी जगह की सुविधाओं के बारे में जवाब जनरेट करने के लिए किया जाता है.
फ़ील्ड
समीक्षा का टाइटल.
यह Google Maps पर मौजूद उपयोगकर्ता की समीक्षा से जुड़ा लिंक होता है.
समीक्षा स्निपेट का आईडी.
जवाब के उस सेगमेंट की शुरुआत जिसे इस सोर्स के लिए एट्रिब्यूट किया गया है. इंडेक्स से सेगमेंट की शुरुआत का पता चलता है. इसे बाइट में मापा जाता है.
एट्रिब्यूट किए गए सेगमेंट के खत्म होने का समय (अलग से उपलब्ध).
इस इवेंट से इंटरैक्शन स्ट्रीम को फिर से शुरू करने के लिए, event_id टोकन का इस्तेमाल किया जाएगा.
ContentStop
कोई विवरण नहीं दिया गया.
इसे हमेशा "content.stop" पर सेट किया जाता है.
कोई विवरण नहीं दिया गया.
इस इवेंट से इंटरैक्शन स्ट्रीम को फिर से शुरू करने के लिए, event_id टोकन का इस्तेमाल किया जाएगा.
ErrorEvent
कोई विवरण नहीं दिया गया.
इसे हमेशा "error" पर सेट किया जाता है.
error Error (ज़रूरी नहीं)
कोई विवरण नहीं दिया गया.
फ़ील्ड
एक यूआरआई, जिससे गड़बड़ी के टाइप की पहचान होती है.
इस मैसेज में गड़बड़ी के बारे में ऐसी जानकारी होती है जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है.
इस इवेंट से इंटरैक्शन स्ट्रीम को फिर से शुरू करने के लिए, event_id टोकन का इस्तेमाल किया जाएगा.
उदाहरण
इंटरैक्शन शुरू होने का समय
{ "event_type": "interaction.start", "interaction": { "id": "v1_ChdTMjQ0YWJ5TUF1TzcxZThQdjRpcnFRcxIXUzI0NGFieU1BdU83MWU4UHY0aXJxUXM", "model": "gemini-3-flash-preview", "object": "interaction", "status": "in_progress" } }
इंटरैक्शन पूरा हुआ
{ "event_type": "interaction.complete", "interaction": { "created": "2025-12-09T18:45:40Z", "id": "v1_ChdTMjQ0YWJ5TUF1TzcxZThQdjRpcnFRcxIXUzI0NGFieU1BdU83MWU4UHY0aXJxUXM", "model": "gemini-3-flash-preview", "object": "interaction", "role": "model", "status": "completed", "updated": "2025-12-09T18:45:40Z", "usage": { "input_tokens_by_modality": [ { "modality": "text", "tokens": 11 } ], "total_cached_tokens": 0, "total_input_tokens": 11, "total_output_tokens": 364, "total_thought_tokens": 1120, "total_tokens": 1495, "total_tool_use_tokens": 0 } } }
इंटरैक्शन के स्टेटस का अपडेट
{ "event_type": "interaction.status_update", "interaction_id": "v1_ChdTMjQ0YWJ5TUF1TzcxZThQdjRpcnFRcxIXUzI0NGFieU1BdU83MWU4UHY0aXJxUXM", "status": "in_progress" }
कॉन्टेंट शुरू करें
{ "event_type": "content.start", "content": { "type": "text" }, "index": 1 }
कॉन्टेंट डेल्टा
{ "event_type": "content.delta", "delta": { "type": "text", "text": "Elara\u2019s life was a symphony of quiet moments. A librarian, she found solace in the hushed aisles, the scent of aged paper, and the predictable rhythm of her days. Her small apartment, meticulously ordered, reflected this internal calm, save" }, "index": 1 }
कॉन्टेंट बंद करना
{ "event_type": "content.stop", "index": 1 }
गड़बड़ी वाला इवेंट
{ "event_type": "error", "error": { "message": "Failed to get completed interaction: Result not found.", "code": "not_found" } }