Gemini Interactions API, एक ऐसा एपीआई है जिसे फ़िलहाल आज़माया जा रहा है. इसकी मदद से डेवलपर, Gemini मॉडल का इस्तेमाल करके जनरेटिव एआई ऐप्लिकेशन बना सकते हैं. Gemini हमारा सबसे बेहतरीन मॉडल है. इसे शुरुआत से ही मल्टीमॉडल बनाने के लिए काम किया गया है. यह अलग-अलग तरह की जानकारी को आसानी से समझ सकता है, उनका इस्तेमाल कर सकता है, और उन्हें एक साथ जोड़ सकता है. जैसे, भाषा, इमेज, ऑडियो, वीडियो, और कोड. Gemini API का इस्तेमाल, कई कामों के लिए किया जा सकता है. जैसे, टेक्स्ट और इमेज के आधार पर तर्क देना, कॉन्टेंट जनरेट करना, बातचीत करने वाले एजेंट, खास जानकारी देने और कॉन्टेंट को अलग-अलग कैटगरी में बांटने वाले सिस्टम बनाना.
इंटरैक्शन बनाना
यह कुकी, नई बातचीत बनाती है.
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल होता है:
model ModelOption (ज़रूरी नहीं)
इंटरैक्शन जनरेट करने के लिए इस्तेमाल किए गए `Model` का नाम.
अगर `agent` नहीं दिया गया है, तो यह प्रॉपर्टी ज़रूरी है.
ये वैल्यू हो सकती हैं:
-
gemini-2.5-proयह हमारा सबसे बेहतरीन मॉडल है. यह कोडिंग करने और मुश्किल सवालों के जवाब देने में माहिर है.
-
gemini-2.5-flashयह हमारा पहला हाइब्रिड रीज़निंग मॉडल है. इसमें 10 लाख टोकन वाली कॉन्टेक्स्ट विंडो और थिंकिंग बजट की सुविधा है.
-
gemini-2.5-flash-preview-09-2025यह 2.5 Flash मॉडल पर आधारित नया मॉडल है. 2.5 Flash Preview, बड़े पैमाने पर प्रोसेसिंग करने, कम समय में जवाब पाने, और ज़्यादा वॉल्यूम वाले ऐसे कामों के लिए सबसे सही है जिनमें सोच-विचार करने की ज़रूरत होती है. साथ ही, यह एजेंट के तौर पर काम करने वाले एआई के इस्तेमाल के लिए भी सबसे सही है.
-
gemini-2.5-flash-liteयह हमारा सबसे छोटा और किफ़ायती मॉडल है. इसे बड़े पैमाने पर इस्तेमाल करने के लिए बनाया गया है.
-
gemini-2.5-flash-lite-preview-09-2025यह Gemini 2.5 Flash lite पर आधारित नया मॉडल है. इसे कम लागत, ज़्यादा थ्रूपुट, और बेहतर क्वालिटी के लिए ऑप्टिमाइज़ किया गया है.
-
gemini-2.5-flash-preview-native-audio-dialogहमारे नेटिव ऑडियो मॉडल, बेहतर पेसिंग, आवाज़ की नैचुरैलिटी, शब्दों की संख्या, और मूड के साथ-साथ बेहतर क्वालिटी वाले ऑडियो आउटपुट के लिए ऑप्टिमाइज़ किए गए हैं.
-
gemini-2.5-flash-image-previewइमेज जनरेट करने वाला हमारा मॉडल, तेज़ी से काम करने के लिए ऑप्टिमाइज़ किया गया है. साथ ही, यह कॉन्टेंट के हिसाब से इमेज जनरेट करने में बेहतर है. टेक्स्ट इनपुट और आउटपुट की कीमत, 2.5 फ़्लैश के बराबर होती है.
-
gemini-2.5-pro-preview-ttsलिखाई को बोली में बदलने वाला हमारा 2.5 Pro ऑडियो मॉडल, कम समय में तेज़ी से बोली जनरेट करने के लिए ऑप्टिमाइज़ किया गया है. इससे ज़्यादा नैचुरल आउटपुट मिलते हैं और प्रॉम्प्ट को आसानी से कंट्रोल किया जा सकता है.
-
gemini-3-pro-previewयह हमारा सबसे ऐडवांस मॉडल है. इसमें एसओटीए रीज़निंग और मल्टीमॉडल को समझने की क्षमता है. साथ ही, इसमें एजेंटिक और वाइब कोडिंग की बेहतरीन सुविधाएँ हैं.
agent AgentOption (ज़रूरी नहीं)
इंटरैक्शन जनरेट करने के लिए इस्तेमाल किए गए `Agent` का नाम.
अगर `model` एट्रिब्यूट की वैल्यू नहीं दी गई है, तो यह एट्रिब्यूट ज़रूरी है.
ये वैल्यू हो सकती हैं:
-
deep-research-pro-preview-12-2025Gemini का Deep Research एजेंट
इंटरैक्शन के लिए इनपुट (मॉडल और एजेंट, दोनों के लिए एक जैसे होते हैं).
इंटरैक्शन के लिए सिस्टम के निर्देश.
टूल के उन एलान की सूची जिन्हें मॉडल, इंटरैक्शन के दौरान कॉल कर सकता है.
इससे यह पक्का किया जाता है कि जनरेट किया गया रिस्पॉन्स, एक JSON ऑब्जेक्ट हो. साथ ही, यह इस फ़ील्ड में दिए गए JSON स्कीमा के मुताबिक हो.
जवाब का MIME टाइप. अगर response_format सेट है, तो यह ज़रूरी है.
सिर्फ़ इनपुट के लिए. इंटरैक्शन को स्ट्रीम किया जाएगा या नहीं.
सिर्फ़ इनपुट के लिए. यह तय करता है कि जवाब और अनुरोध को बाद में वापस पाने के लिए सेव करना है या नहीं.
मॉडल इंटरैक्शन को बैकग्राउंड में चलाना है या नहीं.
generation_config GenerationConfig (optional)
मॉडल कॉन्फ़िगरेशन
मॉडल के साथ इंटरैक्ट करने के लिए कॉन्फ़िगरेशन पैरामीटर.
`agent_config` का विकल्प. यह सिर्फ़ तब लागू होता है, जब `model` सेट किया गया हो.
फ़ील्ड
इससे आउटपुट में रैंडमनेस को कंट्रोल किया जाता है.
सैंपलिंग करते समय, टोकन की ज़्यादा से ज़्यादा कुल संभावना.
डिकोडिंग में इस्तेमाल किया गया सीड, ताकि नतीजे को फिर से जनरेट किया जा सके.
वर्णों के ऐसे क्रम की सूची जिनसे आउटपुट इंटरैक्शन बंद हो जाएगा.
tool_choice ToolChoice (ज़रूरी नहीं)
इंटरैक्शन के लिए टूल चुनने का विकल्प.
संभावित टाइप
ToolChoiceType
इस टाइप के लिए कोई खास फ़ील्ड नहीं है.
ToolChoiceConfig
allowed_tools AllowedTools (ज़रूरी नहीं)
कोई विवरण नहीं दिया गया.
फ़ील्ड
mode ToolChoiceType (ज़रूरी नहीं)
टूल चुनने का मोड.
ये वैल्यू हो सकती हैं:
-
auto -
any -
none -
validated
उन टूल के नाम जिन्हें इस्तेमाल करने की अनुमति है.
thinking_level ThinkingLevel (ज़रूरी नहीं)
मॉडल को कितने थॉट टोकन जनरेट करने चाहिए.
ये वैल्यू हो सकती हैं:
-
low -
high
thinking_summaries ThinkingSummaries (ज़रूरी नहीं)
जवाब में, सोच की खास जानकारी शामिल करनी है या नहीं.
ये वैल्यू हो सकती हैं:
-
auto -
none
जवाब में शामिल किए जाने वाले टोकन की ज़्यादा से ज़्यादा संख्या.
speech_config SpeechConfig (ज़रूरी नहीं)
आवाज़ से इंटरैक्ट करने की सुविधा के लिए कॉन्फ़िगरेशन.
फ़ील्ड
स्पीकर की आवाज़.
बोली जाने वाली भाषा.
वक्ता का नाम, यह प्रॉम्प्ट में दिए गए वक्ता के नाम से मेल खाना चाहिए.
agent_config object (ज़रूरी नहीं)
एजेंट कॉन्फ़िगरेशन
एजेंट के लिए कॉन्फ़िगरेशन.
`generation_config` का विकल्प. यह सिर्फ़ तब लागू होता है, जब `agent` सेट किया गया हो.
संभावित टाइप
पॉलीमॉर्फ़िक डिस्क्रिमिनेटर: type
DynamicAgentConfig
डाइनैमिक एजेंट के लिए कॉन्फ़िगरेशन.
इसका इस्तेमाल, कॉन्टेंट oneof के लिए OpenAPI टाइप डिसक्रिमिनेटर के तौर पर किया जाता है.
इसे हमेशा "dynamic" पर सेट किया जाता है.
DeepResearchAgentConfig
Deep Research एजेंट के लिए कॉन्फ़िगरेशन.
इसका इस्तेमाल, कॉन्टेंट oneof के लिए OpenAPI टाइप डिसक्रिमिनेटर के तौर पर किया जाता है.
इसे हमेशा "deep-research" पर सेट किया जाता है.
thinking_summaries ThinkingSummaries (ज़रूरी नहीं)
जवाब में, सोच की खास जानकारी शामिल करनी है या नहीं.
ये वैल्यू हो सकती हैं:
-
auto -
none
पिछले इंटरैक्शन का आईडी. अगर कोई पिछला इंटरैक्शन नहीं है, तो यह फ़ील्ड मौजूद नहीं होता.
response_modalities ResponseModality (ज़रूरी नहीं)
जवाब के लिए अनुरोध की गई मोडेलिटी (TEXT, IMAGE, AUDIO).
ये वैल्यू हो सकती हैं:
-
text -
image -
audio
जवाब
यह Interaction संसाधन दिखाता है.
सामान्य अनुरोध
प्रतिक्रिया का उदाहरण
{ "created": "2025-11-26T12:25:15Z", "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg", "model": "gemini-2.5-flash", "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_reasoning_tokens": 22, "total_tokens": 49, "total_tool_use_tokens": 0 } }
Multi-turn
प्रतिक्रिया का उदाहरण
{ "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg", "model": "gemini-2.5-flash", "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_reasoning_tokens": 0, "total_tokens": 60, "total_tool_use_tokens": 0 } }
इमेज इनपुट
प्रतिक्रिया का उदाहरण
{ "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg", "model": "gemini-2.5-flash", "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_reasoning_tokens": 0, "total_tokens": 288, "total_tool_use_tokens": 0 } }
फ़ंक्शन कॉलिंग
प्रतिक्रिया का उदाहरण
{ "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg", "model": "gemini-2.5-flash", "status": "requires_action", "object": "interaction", "created": "2025-11-26T12:22:47Z", "updated": "2025-11-26T12:22:47Z", "role": "model", "outputs": [ { "type": "function_call", "function_call": { "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_reasoning_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": "model", "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_reasoning_tokens": 500, "total_tokens": 1520, "total_tool_use_tokens": 0 } }
इंटरैक्शन वापस लाना
यह क्वेरी, `Interaction.id` के आधार पर किसी इंटरैक्शन की पूरी जानकारी वापस लाती है.
पाथ / क्वेरी पैरामीटर
जिस इंटरैक्शन को वापस पाना है उसका यूनीक आइडेंटिफ़ायर.
अगर इसे 'सही है' पर सेट किया जाता है, तो जनरेट किए गए कॉन्टेंट को धीरे-धीरे स्ट्रीम किया जाएगा.
डिफ़ॉल्ट रूप से यह False पर सेट होता है
ज़रूरी नहीं. अगर यह सेट है, तो इवेंट आईडी से मार्क किए गए इवेंट के बाद, इंटरैक्शन स्ट्रीम अगले चंक से फिर से शुरू हो जाती है. इसका इस्तेमाल सिर्फ़ तब किया जा सकता है, जब `stream` सही पर सेट हो.
एपीआई के किस वर्शन का इस्तेमाल करना है.
जवाब
यह Interaction संसाधन दिखाता है.
Get Interaction
प्रतिक्रिया का उदाहरण
{ "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg", "model": "gemini-2.5-flash", "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": "model" }
संसाधन
बातचीत
इंटरैक्शन रिसॉर्स.
फ़ील्ड
model ModelOption (ज़रूरी नहीं)
इंटरैक्शन जनरेट करने के लिए इस्तेमाल किए गए `Model` का नाम.
ये वैल्यू हो सकती हैं:
-
gemini-2.5-proयह हमारा सबसे बेहतरीन मॉडल है. यह कोडिंग करने और मुश्किल सवालों के जवाब देने में माहिर है.
-
gemini-2.5-flashयह हमारा पहला हाइब्रिड रीज़निंग मॉडल है. इसमें 10 लाख टोकन वाली कॉन्टेक्स्ट विंडो और थिंकिंग बजट की सुविधा है.
-
gemini-2.5-flash-preview-09-2025यह 2.5 Flash मॉडल पर आधारित नया मॉडल है. 2.5 Flash Preview, बड़े पैमाने पर प्रोसेसिंग करने, कम समय में जवाब पाने, और ज़्यादा वॉल्यूम वाले ऐसे कामों के लिए सबसे सही है जिनमें सोच-विचार करने की ज़रूरत होती है. साथ ही, यह एजेंट के तौर पर काम करने वाले एआई के इस्तेमाल के लिए भी सबसे सही है.
-
gemini-2.5-flash-liteयह हमारा सबसे छोटा और किफ़ायती मॉडल है. इसे बड़े पैमाने पर इस्तेमाल करने के लिए बनाया गया है.
-
gemini-2.5-flash-lite-preview-09-2025यह Gemini 2.5 Flash lite पर आधारित नया मॉडल है. इसे कम लागत, ज़्यादा थ्रूपुट, और बेहतर क्वालिटी के लिए ऑप्टिमाइज़ किया गया है.
-
gemini-2.5-flash-preview-native-audio-dialogहमारे नेटिव ऑडियो मॉडल, बेहतर पेसिंग, आवाज़ की नैचुरैलिटी, शब्दों की संख्या, और मूड के साथ-साथ बेहतर क्वालिटी वाले ऑडियो आउटपुट के लिए ऑप्टिमाइज़ किए गए हैं.
-
gemini-2.5-flash-image-previewइमेज जनरेट करने वाला हमारा मॉडल, तेज़ी से काम करने के लिए ऑप्टिमाइज़ किया गया है. साथ ही, यह कॉन्टेंट के हिसाब से इमेज जनरेट करने में बेहतर है. टेक्स्ट इनपुट और आउटपुट की कीमत, 2.5 फ़्लैश के बराबर होती है.
-
gemini-2.5-pro-preview-ttsलिखाई को बोली में बदलने वाला हमारा 2.5 Pro ऑडियो मॉडल, कम समय में तेज़ी से बोली जनरेट करने के लिए ऑप्टिमाइज़ किया गया है. इससे ज़्यादा नैचुरल आउटपुट मिलते हैं और प्रॉम्प्ट को आसानी से कंट्रोल किया जा सकता है.
-
gemini-3-pro-previewयह हमारा सबसे ऐडवांस मॉडल है. इसमें एसओटीए रीज़निंग और मल्टीमॉडल को समझने की क्षमता है. साथ ही, इसमें एजेंटिक और वाइब कोडिंग की बेहतरीन सुविधाएँ हैं.
agent AgentOption (ज़रूरी नहीं)
इंटरैक्शन जनरेट करने के लिए इस्तेमाल किए गए `Agent` का नाम.
ये वैल्यू हो सकती हैं:
-
deep-research-pro-preview-12-2025Gemini का Deep Research एजेंट
सिर्फ़ आउटपुट के लिए. इंटरैक्शन पूरा होने के लिए यूनीक आइडेंटिफ़ायर.
सिर्फ़ आउटपुट के लिए. इंटरैक्शन का स्टेटस.
ये वैल्यू हो सकती हैं:
-
in_progress -
requires_action -
completed -
failed -
cancelled
सिर्फ़ आउटपुट के लिए. आईएसओ 8601 फ़ॉर्मैट में, जवाब जनरेट होने का समय (YYYY-MM-DDThh:mm:ssZ).
सिर्फ़ आउटपुट के लिए. आईएसओ 8601 फ़ॉर्मैट (YYYY-MM-DDThh:mm:ssZ) में, जवाब को पिछली बार अपडेट किए जाने का समय.
सिर्फ़ आउटपुट के लिए. इंटरैक्शन की भूमिका.
सिर्फ़ आउटपुट के लिए. मॉडल से मिले जवाब.
सिर्फ़ आउटपुट के लिए. इंटरैक्शन का ऑब्जेक्ट टाइप. इसे हमेशा `interaction` पर सेट किया जाता है.
इसे हमेशा "interaction" पर सेट किया जाता है.
usage Usage (ज़रूरी नहीं)
सिर्फ़ आउटपुट के लिए. इंटरैक्शन के अनुरोध में इस्तेमाल किए गए टोकन के बारे में आंकड़े.
फ़ील्ड
प्रॉम्प्ट (कॉन्टेक्स्ट) में टोकन की संख्या.
input_tokens_by_modality ModalityTokens (ज़रूरी नहीं)
मोड के हिसाब से, इनपुट टोकन के इस्तेमाल की जानकारी.
फ़ील्ड
modality ResponseModality (ज़रूरी नहीं)
टोकन की संख्या से जुड़ी मोडेलिटी.
ये वैल्यू हो सकती हैं:
-
text -
image -
audio
मोडेलिटी के लिए टोकन की संख्या.
प्रॉम्प्ट के कैश मेमोरी में सेव किए गए हिस्से (कैश मेमोरी में सेव किया गया कॉन्टेंट) में मौजूद टोकन की संख्या.
cached_tokens_by_modality ModalityTokens (ज़रूरी नहीं)
मोड के हिसाब से, कैश मेमोरी में सेव किए गए टोकन के इस्तेमाल की जानकारी.
फ़ील्ड
modality ResponseModality (ज़रूरी नहीं)
टोकन की संख्या से जुड़ी मोडेलिटी.
ये वैल्यू हो सकती हैं:
-
text -
image -
audio
मोडेलिटी के लिए टोकन की संख्या.
जनरेट किए गए सभी जवाबों में मौजूद टोकन की कुल संख्या.
output_tokens_by_modality ModalityTokens (optional)
मोड के हिसाब से, आउटपुट टोकन के इस्तेमाल का ब्रेकडाउन.
फ़ील्ड
modality ResponseModality (ज़रूरी नहीं)
टोकन की संख्या से जुड़ी मोडेलिटी.
ये वैल्यू हो सकती हैं:
-
text -
image -
audio
मोडेलिटी के लिए टोकन की संख्या.
टूल का इस्तेमाल करने के बारे में दिए गए प्रॉम्प्ट में मौजूद टोकन की संख्या.
tool_use_tokens_by_modality ModalityTokens (ज़रूरी नहीं)
मोड के हिसाब से, टूल का इस्तेमाल करने के लिए टोकन के इस्तेमाल का ब्रेकडाउन.
फ़ील्ड
modality ResponseModality (ज़रूरी नहीं)
टोकन की संख्या से जुड़ी मोडेलिटी.
ये वैल्यू हो सकती हैं:
-
text -
image -
audio
मोडेलिटी के लिए टोकन की संख्या.
सोचने वाले मॉडल के लिए, आइडिया के टोकन की संख्या.
इंटरैक्शन के अनुरोध के लिए टोकन की कुल संख्या (प्रॉम्प्ट + जवाब + अन्य इंटरनल टोकन).
पिछले इंटरैक्शन का आईडी. अगर कोई पिछला इंटरैक्शन नहीं है, तो यह फ़ील्ड मौजूद नहीं होता.
उदाहरण
उदाहरण
{ "created": "2025-12-04T15:01:45Z", "id": "v1_ChdXS0l4YWZXTk9xbk0xZThQczhEcmlROBIXV0tJeGFmV05PcW5NMWU4UHM4RHJpUTg", "model": "gemini-2.5-flash", "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_reasoning_tokens": 49, "total_tokens": 79, "total_tool_use_tokens": 0 } }
डेटा मॉडल
सामग्री
जवाब का कॉन्टेंट.
संभावित टाइप
पॉलीमॉर्फ़िक डिस्क्रिमिनेटर: type
TextContent
टेक्स्ट कॉन्टेंट ब्लॉक.
टेक्स्ट कॉन्टेंट.
इसका इस्तेमाल, कॉन्टेंट oneof के लिए OpenAPI टाइप डिसक्रिमिनेटर के तौर पर किया जाता है.
इसे हमेशा "text" पर सेट किया जाता है.
annotations Annotation (ज़रूरी नहीं)
मॉडल से जनरेट किए गए कॉन्टेंट के लिए उद्धरण की जानकारी.
फ़ील्ड
जवाब के उस सेगमेंट की शुरुआत जिसे इस सोर्स के लिए एट्रिब्यूट किया गया है. इंडेक्स से सेगमेंट की शुरुआत का पता चलता है. इसे बाइट में मापा जाता है.
एट्रिब्यूट किए गए सेगमेंट के खत्म होने का समय (अलग से उपलब्ध).
टेक्स्ट के किसी हिस्से के लिए एट्रिब्यूट किया गया सोर्स. यह यूआरएल, टाइटल या कोई अन्य आइडेंटिफ़ायर हो सकता है.
ImageContent
इमेज कॉन्टेंट ब्लॉक.
कोई विवरण नहीं दिया गया.
कोई विवरण नहीं दिया गया.
mime_type ImageMimeTypeOption (ज़रूरी नहीं)
कोई विवरण नहीं दिया गया.
ये वैल्यू हो सकती हैं:
-
image/png -
image/jpeg -
image/webp -
image/heic -
image/heif
इसका इस्तेमाल, कॉन्टेंट oneof के लिए OpenAPI टाइप डिसक्रिमिनेटर के तौर पर किया जाता है.
इसे हमेशा "image" पर सेट किया जाता है.
resolution MediaResolution (ज़रूरी नहीं)
मीडिया का रिज़ॉल्यूशन.
ये वैल्यू हो सकती हैं:
-
low -
medium -
high
AudioContent
ऑडियो कॉन्टेंट ब्लॉक.
कोई विवरण नहीं दिया गया.
कोई विवरण नहीं दिया गया.
mime_type AudioMimeTypeOption (optional)
कोई विवरण नहीं दिया गया.
ये वैल्यू हो सकती हैं:
-
audio/wav -
audio/mp3 -
audio/aiff -
audio/aac -
audio/ogg -
audio/flac
इसका इस्तेमाल, कॉन्टेंट oneof के लिए OpenAPI टाइप डिसक्रिमिनेटर के तौर पर किया जाता है.
इसे हमेशा "audio" पर सेट किया जाता है.
DocumentContent
दस्तावेज़ का कॉन्टेंट ब्लॉक.
कोई विवरण नहीं दिया गया.
कोई विवरण नहीं दिया गया.
कोई विवरण नहीं दिया गया.
इसका इस्तेमाल, कॉन्टेंट oneof के लिए OpenAPI टाइप डिसक्रिमिनेटर के तौर पर किया जाता है.
इसे हमेशा "document" पर सेट किया जाता है.
VideoContent
वीडियो कॉन्टेंट ब्लॉक.
कोई विवरण नहीं दिया गया.
कोई विवरण नहीं दिया गया.
mime_type VideoMimeTypeOption (ज़रूरी नहीं)
कोई विवरण नहीं दिया गया.
ये वैल्यू हो सकती हैं:
-
video/mp4 -
video/mpeg -
video/mov -
video/avi -
video/x-flv -
video/mpg -
video/webm -
video/wmv -
video/3gpp
इसका इस्तेमाल, कॉन्टेंट oneof के लिए OpenAPI टाइप डिसक्रिमिनेटर के तौर पर किया जाता है.
इसे हमेशा "video" पर सेट किया जाता है.
resolution MediaResolution (ज़रूरी नहीं)
मीडिया का रिज़ॉल्यूशन.
ये वैल्यू हो सकती हैं:
-
low -
medium -
high
ThoughtContent
सोच से जुड़ा कॉन्टेंट ब्लॉक.
बैकएंड सोर्स से मैच करने वाला सिग्नेचर, ताकि उसे जनरेशन में शामिल किया जा सके.
इसका इस्तेमाल, कॉन्टेंट oneof के लिए OpenAPI टाइप डिसक्रिमिनेटर के तौर पर किया जाता है.
इसे हमेशा "thought" पर सेट किया जाता है.
summary ThoughtSummary (ज़रूरी नहीं)
विचार के बारे में खास जानकारी.
FunctionCallContent
फ़ंक्शन टूल कॉल का कॉन्टेंट ब्लॉक.
कॉल किए जाने वाले टूल का नाम.
फ़ंक्शन में पास किए जाने वाले आर्ग्युमेंट.
इसका इस्तेमाल, कॉन्टेंट oneof के लिए OpenAPI टाइप डिसक्रिमिनेटर के तौर पर किया जाता है.
इसे हमेशा "function_call" पर सेट किया जाता है.
इस टूल कॉल के लिए यूनीक आईडी.
FunctionResultContent
फ़ंक्शन टूल के नतीजे का कॉन्टेंट ब्लॉक.
कॉल किए गए टूल का नाम.
टूल कॉल में कोई गड़बड़ी हुई है या नहीं.
इसका इस्तेमाल, कॉन्टेंट oneof के लिए OpenAPI टाइप डिसक्रिमिनेटर के तौर पर किया जाता है.
इसे हमेशा "function_result" पर सेट किया जाता है.
टूल कॉल का नतीजा.
यह आईडी, फ़ंक्शन कॉल ब्लॉक के आईडी से मेल खाना चाहिए.
CodeExecutionCallContent
कोड को चलाने से जुड़ा कॉन्टेंट.
arguments CodeExecutionCallArguments (ज़रूरी नहीं)
कोड को एक्ज़ीक्यूट करने के लिए पास किए जाने वाले आर्ग्युमेंट.
फ़ील्ड
`code` की प्रोग्रामिंग भाषा.
ये वैल्यू हो सकती हैं:
-
python
वह कोड जिसे एक्ज़ीक्यूट करना है.
इसका इस्तेमाल, कॉन्टेंट oneof के लिए OpenAPI टाइप डिसक्रिमिनेटर के तौर पर किया जाता है.
इसे हमेशा "code_execution_call" पर सेट किया जाता है.
इस टूल कॉल के लिए यूनीक आईडी.
CodeExecutionResultContent
कोड चलाने के नतीजे का कॉन्टेंट.
कोड को चलाने का आउटपुट.
इससे पता चलता है कि कोड चलाने के दौरान कोई गड़बड़ी हुई है या नहीं.
बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.
इसका इस्तेमाल, कॉन्टेंट oneof के लिए OpenAPI टाइप डिसक्रिमिनेटर के तौर पर किया जाता है.
इसे हमेशा "code_execution_result" पर सेट किया जाता है.
यह आईडी, कोड एक्ज़ीक्यूट करने के लिए कॉल ब्लॉक के आईडी से मेल खाना चाहिए.
UrlContextCallContent
यूआरएल के कॉन्टेक्स्ट का कॉन्टेंट.
arguments UrlContextCallArguments (ज़रूरी नहीं)
यूआरएल के कॉन्टेक्स्ट में पास किए जाने वाले आर्ग्युमेंट.
फ़ील्ड
वे यूआरएल जिन्हें फ़ेच करना है.
इसका इस्तेमाल, कॉन्टेंट oneof के लिए OpenAPI टाइप डिसक्रिमिनेटर के तौर पर किया जाता है.
इसे हमेशा "url_context_call" पर सेट किया जाता है.
इस टूल कॉल के लिए यूनीक आईडी.
UrlContextResultContent
यूआरएल के कॉन्टेक्स्ट के हिसाब से खोज के नतीजे में दिखने वाला कॉन्टेंट.
यूआरएल कॉन्टेक्स्ट के नतीजे का हस्ताक्षर.
result UrlContextResult (ज़रूरी नहीं)
यूआरएल के कॉन्टेक्स्ट के नतीजे.
फ़ील्ड
फ़ेच किया गया यूआरएल.
यूआरएल वापस पाने का स्टेटस.
ये वैल्यू हो सकती हैं:
-
success -
error -
paywall -
unsafe
यूआरएल के कॉन्टेक्स्ट में कोई गड़बड़ी हुई है या नहीं.
इसका इस्तेमाल, कॉन्टेंट oneof के लिए OpenAPI टाइप डिसक्रिमिनेटर के तौर पर किया जाता है.
इसे हमेशा "url_context_result" पर सेट किया जाता है.
यह आईडी, यूआरएल कॉन्टेक्स्ट कॉल ब्लॉक के आईडी से मेल खाना चाहिए.
GoogleSearchCallContent
Google Search का कॉन्टेंट.
arguments GoogleSearchCallArguments (optional)
Google Search को पास किए जाने वाले आर्ग्युमेंट.
फ़ील्ड
वेब खोज से जुड़ी क्वेरी, ताकि वेब खोज को फ़ॉलो अप किया जा सके.
इसका इस्तेमाल, कॉन्टेंट oneof के लिए OpenAPI टाइप डिसक्रिमिनेटर के तौर पर किया जाता है.
इसे हमेशा "google_search_call" पर सेट किया जाता है.
इस टूल कॉल के लिए यूनीक आईडी.
GoogleSearchResultContent
Google Search के नतीजों में दिखने वाला कॉन्टेंट.
Google Search के नतीजे का हस्ताक्षर.
result GoogleSearchResult (ज़रूरी नहीं)
Google Search के नतीजे.
फ़ील्ड
खोज के नतीजे का यूआरआई रेफ़रंस.
खोज के नतीजे का टाइटल.
यह वेब कॉन्टेंट स्निपेट होता है. इसे किसी वेब पेज या ऐप्लिकेशन के वेबव्यू में एम्बेड किया जा सकता है.
इससे पता चलता है कि Google Search में कोई गड़बड़ी हुई है या नहीं.
इसका इस्तेमाल, कॉन्टेंट oneof के लिए OpenAPI टाइप डिसक्रिमिनेटर के तौर पर किया जाता है.
इसे हमेशा "google_search_result" पर सेट किया जाता है.
यह आईडी, Google Search पर कॉल ब्लॉक करने की सुविधा के आईडी से मेल खाना चाहिए.
McpServerToolCallContent
MCPServer टूल कॉल का कॉन्टेंट.
कॉल किए गए टूल का नाम.
इस्तेमाल किए गए एमसीपी सर्वर का नाम.
फ़ंक्शन के लिए आर्ग्युमेंट का JSON ऑब्जेक्ट.
इसका इस्तेमाल, कॉन्टेंट oneof के लिए OpenAPI टाइप डिसक्रिमिनेटर के तौर पर किया जाता है.
इसे हमेशा "mcp_server_tool_call" पर सेट किया जाता है.
इस टूल कॉल के लिए यूनीक आईडी.
McpServerToolResultContent
MCPServer टूल के नतीजे का कॉन्टेंट.
उस टूल का नाम जिसे इस टूल कॉल के लिए कॉल किया गया है.
इस्तेमाल किए गए एमसीपी सर्वर का नाम.
इसका इस्तेमाल, कॉन्टेंट oneof के लिए OpenAPI टाइप डिसक्रिमिनेटर के तौर पर किया जाता है.
इसे हमेशा "mcp_server_tool_result" पर सेट किया जाता है.
टूल कॉल का नतीजा.
यह आईडी, एमसीपी सर्वर टूल कॉल ब्लॉक के आईडी से मेल खाना चाहिए.
FileSearchResultContent
फ़ाइल खोजने के नतीजे का कॉन्टेंट.
result FileSearchResult (ज़रूरी नहीं)
फ़ाइल खोजने के नतीजे.
फ़ील्ड
खोज के नतीजे का टाइटल.
खोज के नतीजे का टेक्स्ट.
फ़ाइल खोजने वाले स्टोर का नाम.
इसका इस्तेमाल, कॉन्टेंट oneof के लिए OpenAPI टाइप डिसक्रिमिनेटर के तौर पर किया जाता है.
इसे हमेशा "file_search_result" पर सेट किया जाता है.
उदाहरण
टेक्स्ट
{ "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": "function_result", "name": "get_weather", "call_id": "gth23981", "result": { "weather": "sunny" } }
कोड चलाने के लिए कॉल करना
{ "type": "code_execution_call", "id": "call_123456", "arguments": { "language": "python", "code": "print('hello world')" } }
कोड को एक्ज़ीक्यूट करने का नतीजा
{ "type": "code_execution_result", "call_id": "call_123456", "result": "hello world\n" }
यूआरएल कॉन्टेक्स्ट कॉल
{ "type": "url_context_call", "id": "call_123456", "arguments": { "urls": [ "https://www.example.com" ] } }
यूआरएल के कॉन्टेक्स्ट के हिसाब से मिले नतीजे
{ "type": "url_context_result", "call_id": "call_123456", "result": [ { "url": "https://www.example.com", "status": "SUCCESS" } ] }
Google Search Call
{ "type": "google_search_call", "id": "call_123456", "arguments": { "queries": [ "weather in Boston" ] } }
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 Call
{ "type": "mcp_server_tool_call", "id": "call_123456", "name": "get_forecast", "server_name": "weather_server", "arguments": { "city": "London" } }
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", "result": [ { "text": "search result chunk", "file_search_store": "file_search_store" } ] }
टूल
संभावित टाइप
पॉलीमॉर्फ़िक डिस्क्रिमिनेटर: type
सुविधा
ऐसा टूल जिसका इस्तेमाल मॉडल कर सकता है.
फ़ंक्शन का नाम.
फ़ंक्शन के बारे में जानकारी.
फ़ंक्शन के पैरामीटर के लिए JSON स्कीमा.
कोई विवरण नहीं दिया गया.
इसे हमेशा "function" पर सेट किया जाता है.
GoogleSearch
यह एक ऐसा टूल है जिसका इस्तेमाल मॉडल, Google पर खोजने के लिए कर सकता है.
कोई विवरण नहीं दिया गया.
इसे हमेशा "google_search" पर सेट किया जाता है.
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
अनुमति वाले टूल के नाम.
FileSearch
यह एक ऐसा टूल है जिसका इस्तेमाल मॉडल, फ़ाइलें खोजने के लिए कर सकता है.
फ़ाइल में, खोजने के लिए स्टोर के नाम मौजूद होते हैं.
सिमैंटिक तरीके से खोजे गए डेटा के कितने हिस्सों को वापस पाना है.
सिमैंटिक तौर पर जानकारी पाने के लिए इस्तेमाल किए जाने वाले दस्तावेज़ों और चंक पर लागू करने के लिए मेटाडेटा फ़िल्टर.
कोई विवरण नहीं दिया गया.
इसे हमेशा "file_search" पर सेट किया जाता है.
उदाहरण
फ़ंक्शन
GoogleSearch
CodeExecution
UrlContext
ComputerUse
McpServer
FileSearch
Turn
फ़ील्ड
इस टर्न को शुरू करने वाला. इनपुट के लिए उपयोगकर्ता या मॉडल आउटपुट के लिए मॉडल होना चाहिए.
इस प्रॉपर्टी का इस्तेमाल, बातचीत के टर्न के कॉन्टेंट के लिए किया जाता है.
उदाहरण
उपयोगकर्ता की बारी
{ "role": "user", "content": [ { "type": "text", "text": "user turn" } ] }
मॉडल टर्न
{ "role": "model", "content": [ { "type": "text", "text": "model turn" } ] }
InteractionSseEvent
संभावित टाइप
पॉलीमॉर्फ़िक डिस्क्रिमिनेटर: event_type
InteractionEvent
कोई विवरण नहीं दिया गया.
ये वैल्यू हो सकती हैं:
-
interaction.start -
interaction.complete
कोई विवरण नहीं दिया गया.
इस इवेंट से इंटरैक्शन स्ट्रीम को फिर से शुरू करने के लिए, event_id टोकन का इस्तेमाल किया जाएगा.
InteractionStatusUpdate
कोई विवरण नहीं दिया गया.
कोई विवरण नहीं दिया गया.
ये वैल्यू हो सकती हैं:
-
in_progress -
requires_action -
completed -
failed -
cancelled
कोई विवरण नहीं दिया गया.
इसे हमेशा "interaction.status_update" पर सेट किया जाता है.
इस इवेंट से इंटरैक्शन स्ट्रीम को फिर से शुरू करने के लिए, event_id टोकन का इस्तेमाल किया जाएगा.
ContentStart
कोई विवरण नहीं दिया गया.
कोई विवरण नहीं दिया गया.
कोई विवरण नहीं दिया गया.
इसे हमेशा "content.start" पर सेट किया जाता है.
इस इवेंट से इंटरैक्शन स्ट्रीम को फिर से शुरू करने के लिए, event_id टोकन का इस्तेमाल किया जाएगा.
ContentDelta
कोई विवरण नहीं दिया गया.
कोई विवरण नहीं दिया गया.
इसे हमेशा "content.delta" पर सेट किया जाता है.
इस इवेंट से इंटरैक्शन स्ट्रीम को फिर से शुरू करने के लिए, event_id टोकन का इस्तेमाल किया जाएगा.
delta object (ज़रूरी नहीं)
कोई विवरण नहीं दिया गया.
संभावित टाइप
पॉलीमॉर्फ़िक डिस्क्रिमिनेटर: type
TextDelta
कोई विवरण नहीं दिया गया.
इसका इस्तेमाल, कॉन्टेंट oneof के लिए OpenAPI टाइप डिसक्रिमिनेटर के तौर पर किया जाता है.
इसे हमेशा "text" पर सेट किया जाता है.
annotations Annotation (ज़रूरी नहीं)
मॉडल से जनरेट किए गए कॉन्टेंट के लिए उद्धरण की जानकारी.
फ़ील्ड
जवाब के उस सेगमेंट की शुरुआत जिसे इस सोर्स के लिए एट्रिब्यूट किया गया है. इंडेक्स से सेगमेंट की शुरुआत का पता चलता है. इसे बाइट में मापा जाता है.
एट्रिब्यूट किए गए सेगमेंट के खत्म होने का समय (अलग से उपलब्ध).
टेक्स्ट के किसी हिस्से के लिए एट्रिब्यूट किया गया सोर्स. यह यूआरएल, टाइटल या कोई अन्य आइडेंटिफ़ायर हो सकता है.
ImageDelta
कोई विवरण नहीं दिया गया.
कोई विवरण नहीं दिया गया.
mime_type ImageMimeTypeOption (ज़रूरी नहीं)
कोई विवरण नहीं दिया गया.
ये वैल्यू हो सकती हैं:
-
image/png -
image/jpeg -
image/webp -
image/heic -
image/heif
इसका इस्तेमाल, कॉन्टेंट oneof के लिए OpenAPI टाइप डिसक्रिमिनेटर के तौर पर किया जाता है.
इसे हमेशा "image" पर सेट किया जाता है.
resolution MediaResolution (ज़रूरी नहीं)
मीडिया का रिज़ॉल्यूशन.
ये वैल्यू हो सकती हैं:
-
low -
medium -
high
AudioDelta
कोई विवरण नहीं दिया गया.
कोई विवरण नहीं दिया गया.
mime_type AudioMimeTypeOption (optional)
कोई विवरण नहीं दिया गया.
ये वैल्यू हो सकती हैं:
-
audio/wav -
audio/mp3 -
audio/aiff -
audio/aac -
audio/ogg -
audio/flac
इसका इस्तेमाल, कॉन्टेंट oneof के लिए OpenAPI टाइप डिसक्रिमिनेटर के तौर पर किया जाता है.
इसे हमेशा "audio" पर सेट किया जाता है.
DocumentDelta
कोई विवरण नहीं दिया गया.
कोई विवरण नहीं दिया गया.
कोई विवरण नहीं दिया गया.
इसका इस्तेमाल, कॉन्टेंट oneof के लिए OpenAPI टाइप डिसक्रिमिनेटर के तौर पर किया जाता है.
इसे हमेशा "document" पर सेट किया जाता है.
VideoDelta
कोई विवरण नहीं दिया गया.
कोई विवरण नहीं दिया गया.
mime_type VideoMimeTypeOption (ज़रूरी नहीं)
कोई विवरण नहीं दिया गया.
ये वैल्यू हो सकती हैं:
-
video/mp4 -
video/mpeg -
video/mov -
video/avi -
video/x-flv -
video/mpg -
video/webm -
video/wmv -
video/3gpp
इसका इस्तेमाल, कॉन्टेंट oneof के लिए OpenAPI टाइप डिसक्रिमिनेटर के तौर पर किया जाता है.
इसे हमेशा "video" पर सेट किया जाता है.
resolution MediaResolution (ज़रूरी नहीं)
मीडिया का रिज़ॉल्यूशन.
ये वैल्यू हो सकती हैं:
-
low -
medium -
high
ThoughtSummaryDelta
इसका इस्तेमाल, कॉन्टेंट oneof के लिए OpenAPI टाइप डिसक्रिमिनेटर के तौर पर किया जाता है.
इसे हमेशा "thought_summary" पर सेट किया जाता है.
कोई विवरण नहीं दिया गया.
ThoughtSignatureDelta
बैकएंड सोर्स से मैच करने वाला सिग्नेचर, ताकि उसे जनरेशन में शामिल किया जा सके.
इसका इस्तेमाल, कॉन्टेंट oneof के लिए OpenAPI टाइप डिसक्रिमिनेटर के तौर पर किया जाता है.
इसे हमेशा "thought_signature" पर सेट किया जाता है.
FunctionCallDelta
कोई विवरण नहीं दिया गया.
कोई विवरण नहीं दिया गया.
इसका इस्तेमाल, कॉन्टेंट oneof के लिए OpenAPI टाइप डिसक्रिमिनेटर के तौर पर किया जाता है.
इसे हमेशा "function_call" पर सेट किया जाता है.
इस टूल कॉल के लिए यूनीक आईडी.
FunctionResultDelta
कोई विवरण नहीं दिया गया.
कोई विवरण नहीं दिया गया.
इसका इस्तेमाल, कॉन्टेंट oneof के लिए OpenAPI टाइप डिसक्रिमिनेटर के तौर पर किया जाता है.
इसे हमेशा "function_result" पर सेट किया जाता है.
टूल कॉल के नतीजे में अंतर.
यह आईडी, फ़ंक्शन कॉल ब्लॉक के आईडी से मेल खाना चाहिए.
CodeExecutionCallDelta
arguments CodeExecutionCallArguments (ज़रूरी नहीं)
कोई विवरण नहीं दिया गया.
फ़ील्ड
`code` की प्रोग्रामिंग भाषा.
ये वैल्यू हो सकती हैं:
-
python
वह कोड जिसे एक्ज़ीक्यूट करना है.
इसका इस्तेमाल, कॉन्टेंट oneof के लिए OpenAPI टाइप डिसक्रिमिनेटर के तौर पर किया जाता है.
इसे हमेशा "code_execution_call" पर सेट किया जाता है.
इस टूल कॉल के लिए यूनीक आईडी.
CodeExecutionResultDelta
कोई विवरण नहीं दिया गया.
कोई विवरण नहीं दिया गया.
कोई विवरण नहीं दिया गया.
इसका इस्तेमाल, कॉन्टेंट oneof के लिए OpenAPI टाइप डिसक्रिमिनेटर के तौर पर किया जाता है.
इसे हमेशा "code_execution_result" पर सेट किया जाता है.
यह आईडी, फ़ंक्शन कॉल ब्लॉक के आईडी से मेल खाना चाहिए.
UrlContextCallDelta
arguments UrlContextCallArguments (ज़रूरी नहीं)
कोई विवरण नहीं दिया गया.
फ़ील्ड
वे यूआरएल जिन्हें फ़ेच करना है.
इसका इस्तेमाल, कॉन्टेंट oneof के लिए OpenAPI टाइप डिसक्रिमिनेटर के तौर पर किया जाता है.
इसे हमेशा "url_context_call" पर सेट किया जाता है.
इस टूल कॉल के लिए यूनीक आईडी.
UrlContextResultDelta
कोई विवरण नहीं दिया गया.
result UrlContextResult (ज़रूरी नहीं)
कोई विवरण नहीं दिया गया.
फ़ील्ड
फ़ेच किया गया यूआरएल.
यूआरएल वापस पाने का स्टेटस.
ये वैल्यू हो सकती हैं:
-
success -
error -
paywall -
unsafe
कोई विवरण नहीं दिया गया.
इसका इस्तेमाल, कॉन्टेंट oneof के लिए OpenAPI टाइप डिसक्रिमिनेटर के तौर पर किया जाता है.
इसे हमेशा "url_context_result" पर सेट किया जाता है.
यह आईडी, फ़ंक्शन कॉल ब्लॉक के आईडी से मेल खाना चाहिए.
GoogleSearchCallDelta
arguments GoogleSearchCallArguments (optional)
कोई विवरण नहीं दिया गया.
फ़ील्ड
वेब खोज से जुड़ी क्वेरी, ताकि वेब खोज को फ़ॉलो अप किया जा सके.
इसका इस्तेमाल, कॉन्टेंट oneof के लिए OpenAPI टाइप डिसक्रिमिनेटर के तौर पर किया जाता है.
इसे हमेशा "google_search_call" पर सेट किया जाता है.
इस टूल कॉल के लिए यूनीक आईडी.
GoogleSearchResultDelta
कोई विवरण नहीं दिया गया.
result GoogleSearchResult (ज़रूरी नहीं)
कोई विवरण नहीं दिया गया.
फ़ील्ड
खोज के नतीजे का यूआरआई रेफ़रंस.
खोज के नतीजे का टाइटल.
यह वेब कॉन्टेंट स्निपेट होता है. इसे किसी वेब पेज या ऐप्लिकेशन के वेबव्यू में एम्बेड किया जा सकता है.
कोई विवरण नहीं दिया गया.
इसका इस्तेमाल, कॉन्टेंट oneof के लिए OpenAPI टाइप डिसक्रिमिनेटर के तौर पर किया जाता है.
इसे हमेशा "google_search_result" पर सेट किया जाता है.
यह आईडी, फ़ंक्शन कॉल ब्लॉक के आईडी से मेल खाना चाहिए.
McpServerToolCallDelta
कोई विवरण नहीं दिया गया.
कोई विवरण नहीं दिया गया.
कोई विवरण नहीं दिया गया.
इसका इस्तेमाल, कॉन्टेंट oneof के लिए OpenAPI टाइप डिसक्रिमिनेटर के तौर पर किया जाता है.
इसे हमेशा "mcp_server_tool_call" पर सेट किया जाता है.
इस टूल कॉल के लिए यूनीक आईडी.
McpServerToolResultDelta
कोई विवरण नहीं दिया गया.
कोई विवरण नहीं दिया गया.
इसका इस्तेमाल, कॉन्टेंट oneof के लिए OpenAPI टाइप डिसक्रिमिनेटर के तौर पर किया जाता है.
इसे हमेशा "mcp_server_tool_result" पर सेट किया जाता है.
टूल कॉल के नतीजे में अंतर.
यह आईडी, फ़ंक्शन कॉल ब्लॉक के आईडी से मेल खाना चाहिए.
FileSearchResultDelta
result FileSearchResult (ज़रूरी नहीं)
कोई विवरण नहीं दिया गया.
फ़ील्ड
खोज के नतीजे का टाइटल.
खोज के नतीजे का टेक्स्ट.
फ़ाइल खोजने वाले स्टोर का नाम.
इसका इस्तेमाल, कॉन्टेंट oneof के लिए OpenAPI टाइप डिसक्रिमिनेटर के तौर पर किया जाता है.
इसे हमेशा "file_search_result" पर सेट किया जाता है.
ContentStop
कोई विवरण नहीं दिया गया.
कोई विवरण नहीं दिया गया.
इसे हमेशा "content.stop" पर सेट किया जाता है.
इस इवेंट से इंटरैक्शन स्ट्रीम को फिर से शुरू करने के लिए, event_id टोकन का इस्तेमाल किया जाएगा.
ErrorEvent
कोई विवरण नहीं दिया गया.
इसे हमेशा "error" पर सेट किया जाता है.
error Error (ज़रूरी नहीं)
कोई विवरण नहीं दिया गया.
फ़ील्ड
यह यूआरआई, गड़बड़ी के टाइप की पहचान करता है.
इस मैसेज में गड़बड़ी के बारे में ऐसी जानकारी होती है जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है.
इस इवेंट से इंटरैक्शन स्ट्रीम को फिर से शुरू करने के लिए, event_id टोकन का इस्तेमाल किया जाएगा.
उदाहरण
इंटरैक्शन शुरू होने का समय
{ "event_type": "interaction.start", "interaction": { "id": "v1_ChdTMjQ0YWJ5TUF1TzcxZThQdjRpcnFRcxIXUzI0NGFieU1BdU83MWU4UHY0aXJxUXM", "model": "gemini-2.5-flash", "object": "interaction", "status": "in_progress" } }
इंटरैक्शन पूरा हुआ
{ "event_type": "interaction.complete", "interaction": { "created": "2025-12-09T18:45:40Z", "id": "v1_ChdTMjQ0YWJ5TUF1TzcxZThQdjRpcnFRcxIXUzI0NGFieU1BdU83MWU4UHY0aXJxUXM", "model": "gemini-2.5-flash", "object": "interaction", "outputs": [ { "signature": "CoMDAXLI2nynRYojJIy6B1Jh9os2crpWLfB0+19xcLsGG46bd8wjkF/6RNlRUdvHrXyjsHkG0BZFcuO/bPOyA6Xh5jANNgx82wPHjGExN8A4ZQn56FlMwyZoqFVQz0QyY1lfibFJ2zU3J87uw26OewzcuVX0KEcs+GIsZa3EA6WwqhbsOd3wtZB3Ua2Qf98VAWZTS5y/tWpql7jnU3/CU7pouxQr/Bwft3hwnJNesQ9/dDJTuaQ8Zprh9VRWf1aFFjpIueOjBRrlT3oW6/y/eRl/Gt9BQXCYTqg/38vHFUU4Wo/d9dUpvfCe/a3o97t2Jgxp34oFKcsVb4S5WJrykIkw+14DzVnTpCpbQNFckqvFLuqnJCkL0EQFtunBXI03FJpPu3T1XU6id8S7ojoJQZSauGUCgmaLqUGdMrd08oo81ecoJSLs51Re9N/lISGmjWFPGpqJLoGq6uo4FHz58hmeyXCgHG742BHz2P3MiH1CXHUT2J8mF6zLhf3SR9Qb3lkrobAh", "type": "thought" }, { "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", "type": "text" }, { "text": " for one beloved anomaly: a chipped porcelain teacup, inherited from her grandmother, which held her morning Earl Grey.\n\nOne Tuesday, stirring her tea, Elara paused. At the bottom, nestled against the porcelain, was a star.", "type": "text" }, { "text": " Not a star-shaped tea leaf, but a miniature, perfectly formed celestial body, radiating a faint, cool luminescence. Before she could gasp, it dissolved, leaving only the amber swirl of her brew. She dismissed it as a trick of", "type": "text" }, { "text": " tired eyes.\n\nBut the next morning, a gossamer-thin feather, smaller than an eyelash and shimmering with iridescent hues, floated on the surface. It vanished the moment she tried to touch it. A week later, a single,", "type": "text" }, { "text": " impossibly delicate bloom, like spun moonbeam, unfolded in her cup before fading into nothingness.\n\nThese weren't illusions. Each day, Elara\u2019s chipped teacup offered a fleeting, exquisite secret. A tiny, perfect", "type": "text" }, { "text": " crystal, a miniature spiral nebula, a fragment of rainbow caught in liquid form. They never lingered, never accumulated, simply *were* and then *weren't*, leaving behind a residue of quiet wonder.\n\nElara never spoke", "type": "text" }, { "text": " of it. It was her private wellspring, a daily reminder that magic could exist in the smallest, most overlooked corners of the world. Her routine remained unchanged, her external life a picture of calm, but inside, a secret garden blo", "type": "text" }, { "text": "omed. Each dawn brought not just tea, but the silent promise of extraordinary beauty, waiting patiently in a chipped teacup.", "type": "text" } ], "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_reasoning_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" } }