Gemini API

Gemini Interactions API, एक एक्सपेरिमेंटल एपीआई है. इसकी मदद से डेवलपर, Gemini के मॉडल का इस्तेमाल करके जनरेटिव एआई ऐप्लिकेशन बना सकते हैं. Gemini हमारा सबसे बेहतरीन मॉडल है. इसे शुरुआत से ही मल्टीमॉडल बनाने के लिए काम किया गया है. यह अलग-अलग तरह की जानकारी को आसानी से समझ सकता है और उसे एक साथ इस्तेमाल कर सकता है. जैसे, भाषा, इमेज, ऑडियो, वीडियो, और कोड. Gemini API का इस्तेमाल, कई कामों के लिए किया जा सकता है. जैसे, टेक्स्ट और इमेज के आधार पर तर्क देना, कॉन्टेंट जनरेट करना, बातचीत करने वाले एजेंट बनाना, खास जानकारी देने और कॉन्टेंट को अलग-अलग कैटगरी में बांटने वाले सिस्टम बनाना.

इंटरैक्शन बनाना

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

यह कुकी, नई बातचीत बनाती है.

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

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

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-preview

    Gemini 3.1 Flash TTS: यह मॉडल, कम समय में बेहतर तरीके से बोली जनरेट करता है. इसमें आपको नैचुरल आउटपुट, प्रॉम्प्ट को कंट्रोल करने की सुविधा, और सटीक नैरेशन कंट्रोल के लिए नए एक्सप्रेसिव ऑडियो टैग मिलते हैं.

  • lyria-3-clip-preview

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

  • lyria-3-pro-preview

    यह पूरा गाना जनरेट करने वाला हमारा ऐडवांस मॉडल है. यह संगीत की बारीकियों को अच्छी तरह से समझता है. इसे अलग-अलग म्यूज़िकल स्टाइल में सटीक स्ट्रक्चर कंट्रोल और मुश्किल ट्रांज़िशन के लिए ऑप्टिमाइज़ किया गया है.

वह मॉडल जो आपके प्रॉम्प्ट को पूरा करेगा.\n\nज़्यादा जानकारी के लिए, [मॉडल](https://ai.google.dev/gemini-api/docs/models) देखें.

agent AgentOption  (ज़रूरी नहीं)

इंटरैक्शन जनरेट करने के लिए इस्तेमाल किए गए `Agent` का नाम.
अगर `model` एट्रिब्यूट की वैल्यू नहीं दी गई है, तो यह एट्रिब्यूट ज़रूरी है.

ये वैल्यू हो सकती हैं:

  • deep-research-pro-preview-12-2025

    Gemini की Deep Research सुविधा देने वाला एजेंट

  • deep-research-preview-04-2026

    Gemini की Deep Research सुविधा देने वाला एजेंट

  • deep-research-max-preview-04-2026

    Gemini Deep Research Max Agent

जिस एजेंट के साथ इंटरैक्ट करना है.

input Content या array (Content) या array (Turn) या string  (ज़रूरी है)

इंटरैक्शन के लिए इनपुट (मॉडल और एजेंट, दोनों के लिए एक जैसे होते हैं).

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

इंटरैक्शन के लिए सिस्टम के निर्देश.

tools array (Tool)  (ज़रूरी नहीं)

टूल के उन एलान की सूची जिन्हें मॉडल, इंटरैक्शन के दौरान कॉल कर सकता है.

response_format object  (ज़रूरी नहीं)

इससे यह पक्का किया जाता है कि जनरेट किया गया रिस्पॉन्स, एक JSON ऑब्जेक्ट हो. साथ ही, यह इस फ़ील्ड में दिए गए JSON स्कीमा के मुताबिक हो.

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

जवाब का MIME टाइप. अगर response_format सेट किया गया है, तो यह ज़रूरी है.

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

सिर्फ़ इनपुट के लिए. क्या इंटरैक्शन को स्ट्रीम किया जाएगा.

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

सिर्फ़ इनपुट के लिए. जवाब और अनुरोध को बाद में वापस पाने के लिए सेव करना है या नहीं.

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

सिर्फ़ इनपुट के लिए. मॉडल इंटरैक्शन को बैकग्राउंड में चलाना है या नहीं.

generation_config GenerationConfig  (optional)

मॉडल कॉन्फ़िगरेशन
मॉडल इंटरैक्शन के लिए कॉन्फ़िगरेशन पैरामीटर.
`agent_config` का विकल्प. यह सिर्फ़ तब लागू होता है, जब `model` सेट किया गया हो.

मॉडल इंटरैक्शन के लिए कॉन्फ़िगरेशन पैरामीटर.

फ़ील्ड

temperature number  (ज़रूरी नहीं)

इससे आउटपुट में रैंडमनेस को कंट्रोल किया जाता है.

top_p number  (ज़रूरी नहीं)

सैंपलिंग करते समय, टोकन की ज़्यादा से ज़्यादा संचयी संभावना पर विचार किया जाता है.

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

डिकोडिंग में इस्तेमाल किया गया सीड, ताकि नतीजे को फिर से जनरेट किया जा सके.

stop_sequences array (string)  (optional)

वर्णों के ऐसे क्रम की सूची जिनसे आउटपुट इंटरैक्शन बंद हो जाएगा.

thinking_level ThinkingLevel  (optional)

मॉडल को कितने थॉट टोकन जनरेट करने चाहिए.

ये वैल्यू हो सकती हैं:

  • minimal
  • low
  • medium
  • high

thinking_summaries ThinkingSummaries  (ज़रूरी नहीं)

जवाब में, सोच की खास जानकारी शामिल करनी है या नहीं.

ये वैल्यू हो सकती हैं:

  • auto
  • none

max_output_tokens integer  (optional)

जवाब में शामिल किए जाने वाले टोकन की ज़्यादा से ज़्यादा संख्या.

speech_config SpeechConfig  (ज़रूरी नहीं)

बोलकर इंटरैक्ट करने की सुविधा के लिए कॉन्फ़िगरेशन.

बोलकर इंटरैक्ट करने की सुविधा के लिए कॉन्फ़िगरेशन.

फ़ील्ड

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

स्पीकर की आवाज़.

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

बोली जाने वाली भाषा.

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

वक्ता का नाम, यह प्रॉम्प्ट में दिए गए वक्ता के नाम से मेल खाना चाहिए.

image_config ImageConfig  (optional)

इमेज इंटरैक्शन के लिए कॉन्फ़िगरेशन.

इमेज इंटरैक्शन के लिए कॉन्फ़िगरेशन.

फ़ील्ड

aspect_ratio enum (string)  (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
image_size enum (string)  (optional)

कोई विवरण नहीं दिया गया.

ये वैल्यू हो सकती हैं:

  • 1K
  • 2K
  • 4K
  • 512
tool_choice ToolChoiceConfig या ToolChoiceType  (ज़रूरी नहीं)

टूल चुनने की सुविधा का कॉन्फ़िगरेशन.

agent_config object  (ज़रूरी नहीं)

एजेंट कॉन्फ़िगरेशन
एजेंट के लिए कॉन्फ़िगरेशन.
`generation_config` का विकल्प. यह सिर्फ़ तब लागू होता है, जब `agent` सेट किया गया हो.

संभावित टाइप

पॉलीमॉर्फ़िक डिसक्रिमिनेटर: type

DynamicAgentConfig

डाइनैमिक एजेंट के लिए कॉन्फ़िगरेशन.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "dynamic" पर सेट किया जाता है.

DeepResearchAgentConfig

Deep Research एजेंट के लिए कॉन्फ़िगरेशन.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "deep-research" पर सेट किया जाता है.

thinking_summaries ThinkingSummaries  (ज़रूरी नहीं)

जवाब में, सोच की खास जानकारी शामिल करनी है या नहीं.

ये वैल्यू हो सकती हैं:

  • auto
  • none

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

जवाब में विज़ुअलाइज़ेशन शामिल करने हैं या नहीं.

ये वैल्यू हो सकती हैं:

  • off
  • auto
collaborative_planning boolean  (ज़रूरी नहीं)

इस कुकी से, Deep Research एजेंट के लिए ह्यूमन-इन-द-लूप प्लानिंग की सुविधा चालू होती है. अगर इसे true पर सेट किया जाता है, तो Deep Research एजेंट अपने जवाब में रिसर्च प्लान देगा. इसके बाद, एजेंट सिर्फ़ तब आगे बढ़ेगा, जब उपयोगकर्ता अगले टर्न में प्लान की पुष्टि करेगा.

previous_interaction_id string  (optional)

पिछले इंटरैक्शन का आईडी. अगर कोई पिछला इंटरैक्शन नहीं है, तो यह फ़ील्ड मौजूद नहीं होता.

response_modalities ResponseModality  (optional)

जवाब के लिए अनुरोध की गई मोडेलिटी (TEXT, IMAGE, AUDIO).

ये वैल्यू हो सकती हैं:

  • text
  • image
  • audio
  • video
  • document

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

इंटरैक्शन के लिए सेवा का टियर.

ये वैल्यू हो सकती हैं:

  • 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
  }
}

इंटरैक्शन वापस पाना

get https://generativelanguage.googleapis.com/v1beta/interactions/{id}

यह क्वेरी, `Interaction.id` के आधार पर किसी इंटरैक्शन की पूरी जानकारी वापस लाती है.

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

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

जिस इंटरैक्शन को वापस पाना है उसका यूनीक आइडेंटिफ़ायर.

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

अगर इसे 'सही है' पर सेट किया जाता है, तो जनरेट किए गए कॉन्टेंट को धीरे-धीरे स्ट्रीम किया जाएगा.

डिफ़ॉल्ट रूप से यह इस पर सेट होता है: False

last_event_id string  (optional)

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

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

इसे सही पर सेट करने पर, जवाब में इनपुट शामिल किया जाता है.

डिफ़ॉल्ट रूप से यह इस पर सेट होता है: False

api_version string  (optional)

एपीआई के किस वर्शन का इस्तेमाल करना है.

जवाब

यह 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?"
    }
  ]
}

इंटरैक्शन मिटाना

delete https://generativelanguage.googleapis.com/v1beta/interactions/{id}

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

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

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

मिटाने के लिए इंटरैक्शन का यूनीक आइडेंटिफ़ायर.

api_version string  (optional)

एपीआई के किस वर्शन का इस्तेमाल करना है.

जवाब

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

इंटरैक्शन मिटाना

इंटरैक्शन रद्द करना

post https://generativelanguage.googleapis.com/v1beta/interactions/{id}/cancel

यह आईडी के हिसाब से इंटरैक्शन रद्द करता है. यह सिर्फ़ उन बैकग्राउंड इंटरैक्शन पर लागू होता है जो अब भी चल रहे हैं.

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

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

जिस इंटरैक्शन को रद्द करना है उसका यूनीक आइडेंटिफ़ायर.

api_version string  (optional)

एपीआई के किस वर्शन का इस्तेमाल करना है.

जवाब

यह 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-preview

    Gemini 3.1 Flash TTS: यह मॉडल, कम समय में बेहतर तरीके से बोली जनरेट करता है. इसमें आपको नैचुरल आउटपुट, प्रॉम्प्ट को कंट्रोल करने की सुविधा, और सटीक नैरेशन कंट्रोल के लिए नए एक्सप्रेसिव ऑडियो टैग मिलते हैं.

  • lyria-3-clip-preview

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

  • lyria-3-pro-preview

    यह पूरा गाना जनरेट करने वाला हमारा ऐडवांस मॉडल है. यह संगीत की बारीकियों को अच्छी तरह से समझता है. इसे अलग-अलग म्यूज़िकल स्टाइल में सटीक स्ट्रक्चर कंट्रोल और मुश्किल ट्रांज़िशन के लिए ऑप्टिमाइज़ किया गया है.

वह मॉडल जो आपके प्रॉम्प्ट को पूरा करेगा.\n\nज़्यादा जानकारी के लिए, [मॉडल](https://ai.google.dev/gemini-api/docs/models) देखें.

agent AgentOption  (ज़रूरी नहीं)

इंटरैक्शन जनरेट करने के लिए इस्तेमाल किए गए `Agent` का नाम.

ये वैल्यू हो सकती हैं:

  • deep-research-pro-preview-12-2025

    Gemini की Deep Research सुविधा देने वाला एजेंट

  • deep-research-preview-04-2026

    Gemini की Deep Research सुविधा देने वाला एजेंट

  • deep-research-max-preview-04-2026

    Gemini Deep Research Max Agent

जिस एजेंट के साथ इंटरैक्ट करना है.

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

ज़रूरी है. सिर्फ़ आउटपुट के लिए. इंटरैक्शन पूरा होने के लिए यूनीक आइडेंटिफ़ायर.

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

ज़रूरी है. सिर्फ़ आउटपुट के लिए. इंटरैक्शन का स्टेटस.

ये वैल्यू हो सकती हैं:

  • in_progress
  • requires_action
  • completed
  • failed
  • cancelled
  • incomplete
created string  (ज़रूरी नहीं)

ज़रूरी है. सिर्फ़ आउटपुट के लिए. आईएसओ 8601 फ़ॉर्मैट (YYYY-MM-DDThh:mm:ssZ) में, जवाब जनरेट होने का समय.

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

ज़रूरी है. सिर्फ़ आउटपुट के लिए. आईएसओ 8601 फ़ॉर्मैट (YYYY-MM-DDThh:mm:ssZ) में, जवाब को पिछली बार अपडेट किए जाने का समय.

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

सिर्फ़ आउटपुट के लिए. इंटरैक्शन की भूमिका.

outputs array (Content)  (ज़रूरी नहीं)

सिर्फ़ आउटपुट के लिए. मॉडल से मिले जवाब.

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

इंटरैक्शन के लिए सिस्टम को दिया गया निर्देश.

tools array (Tool)  (ज़रूरी नहीं)

टूल के उन एलान की सूची जिन्हें मॉडल, इंटरैक्शन के दौरान कॉल कर सकता है.

usage Usage  (ज़रूरी नहीं)

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

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

फ़ील्ड

total_input_tokens integer  (optional)

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

input_tokens_by_modality ModalityTokens  (ज़रूरी नहीं)

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

जवाब देने के एक तरीके के लिए टोकन की संख्या.

फ़ील्ड

modality ResponseModality  (ज़रूरी नहीं)

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

ये वैल्यू हो सकती हैं:

  • text
  • image
  • audio
  • video
  • document

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

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

total_cached_tokens integer  (optional)

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

cached_tokens_by_modality ModalityTokens  (optional)

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

जवाब देने के एक तरीके के लिए टोकन की संख्या.

फ़ील्ड

modality ResponseModality  (ज़रूरी नहीं)

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

ये वैल्यू हो सकती हैं:

  • text
  • image
  • audio
  • video
  • document

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

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

total_output_tokens integer  (optional)

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

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

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

जवाब देने के एक तरीके के लिए टोकन की संख्या.

फ़ील्ड

modality ResponseModality  (ज़रूरी नहीं)

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

ये वैल्यू हो सकती हैं:

  • text
  • image
  • audio
  • video
  • document

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

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

total_tool_use_tokens integer  (optional)

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

tool_use_tokens_by_modality ModalityTokens  (ज़रूरी नहीं)

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

जवाब देने के एक तरीके के लिए टोकन की संख्या.

फ़ील्ड

modality ResponseModality  (ज़रूरी नहीं)

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

ये वैल्यू हो सकती हैं:

  • text
  • image
  • audio
  • video
  • document

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

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

total_thought_tokens integer  (optional)

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

total_tokens integer  (optional)

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

response_modalities ResponseModality  (ज़रूरी नहीं)

जवाब के लिए अनुरोध की गई मोडेलिटी (TEXT, IMAGE, AUDIO).

ये वैल्यू हो सकती हैं:

  • text
  • image
  • audio
  • video
  • document

response_format object  (ज़रूरी नहीं)

इससे यह पक्का किया जाता है कि जनरेट किया गया रिस्पॉन्स, एक JSON ऑब्जेक्ट हो. साथ ही, यह इस फ़ील्ड में दिए गए JSON स्कीमा के मुताबिक हो.

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

जवाब का MIME टाइप. अगर response_format सेट किया गया है, तो यह ज़रूरी है.

previous_interaction_id string  (optional)

पिछले इंटरैक्शन का आईडी. अगर कोई पिछला इंटरैक्शन नहीं है, तो यह फ़ील्ड मौजूद नहीं होता.

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

इंटरैक्शन के लिए सेवा का टियर.

ये वैल्यू हो सकती हैं:

  • flex
  • standard
  • priority
input Content या array (Content) या array (Turn) या string  (ज़रूरी नहीं)

इंटरैक्शन के लिए इनपुट.

agent_config object  (ज़रूरी नहीं)

एजेंट के साथ इंटरैक्शन के लिए कॉन्फ़िगरेशन पैरामीटर.

संभावित टाइप

पॉलीमॉर्फ़िक डिसक्रिमिनेटर: type

DynamicAgentConfig

डाइनैमिक एजेंट के लिए कॉन्फ़िगरेशन.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "dynamic" पर सेट किया जाता है.

DeepResearchAgentConfig

Deep Research एजेंट के लिए कॉन्फ़िगरेशन.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "deep-research" पर सेट किया जाता है.

thinking_summaries ThinkingSummaries  (ज़रूरी नहीं)

जवाब में, सोच की खास जानकारी शामिल करनी है या नहीं.

ये वैल्यू हो सकती हैं:

  • auto
  • none

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

जवाब में विज़ुअलाइज़ेशन शामिल करने हैं या नहीं.

ये वैल्यू हो सकती हैं:

  • off
  • auto
collaborative_planning boolean  (ज़रूरी नहीं)

इस कुकी से, 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

टेक्स्ट कॉन्टेंट वाला ब्लॉक.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "text" पर सेट किया जाता है.

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

ज़रूरी है. टेक्स्ट कॉन्टेंट.

annotations Annotation  (ज़रूरी नहीं)

मॉडल से जनरेट किए गए कॉन्टेंट के लिए उद्धरण की जानकारी.

मॉडल से जनरेट किए गए कॉन्टेंट के लिए उद्धरण की जानकारी.

संभावित टाइप

पॉलीमॉर्फ़िक डिसक्रिमिनेटर: type

UrlCitation

यूआरएल उद्धरण एनोटेशन.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "url_citation" पर सेट किया जाता है.

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

यूआरएल.

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

यूआरएल का टाइटल.

start_index integer  (optional)

जवाब के उस सेगमेंट की शुरुआत जिसे इस सोर्स के लिए एट्रिब्यूट किया गया है. इंडेक्स से सेगमेंट की शुरुआत का पता चलता है. इसे बाइट में मापा जाता है.

end_index integer  (optional)

एट्रिब्यूट किए गए सेगमेंट के खत्म होने का समय (अलग से उपलब्ध).

FileCitation

फ़ाइल के उद्धरण का एनोटेशन.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "file_citation" पर सेट किया जाता है.

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

फ़ाइल का यूआरआई.

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

फ़ाइल का नाम.

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

टेक्स्ट के किसी हिस्से के लिए एट्रिब्यूट किया गया सोर्स.

start_index integer  (optional)

जवाब के उस सेगमेंट की शुरुआत जिसे इस सोर्स के लिए एट्रिब्यूट किया गया है. इंडेक्स से सेगमेंट की शुरुआत का पता चलता है. इसे बाइट में मापा जाता है.

end_index integer  (optional)

एट्रिब्यूट किए गए सेगमेंट के खत्म होने का समय (अलग से उपलब्ध).

PlaceCitation

जगह के उद्धरण का एनोटेशन.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "place_citation" पर सेट किया जाता है.

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

जगह का आईडी, `places/{place_id}` फ़ॉर्मैट में होता है.

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

जगह का टाइटल.

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

जगह का यूआरआई रेफ़रंस.

review_snippets ReviewSnippet  (ज़रूरी नहीं)

समीक्षाओं के ऐसे स्निपेट जिनका इस्तेमाल, Google Maps में किसी जगह की सुविधाओं के बारे में जवाब जनरेट करने के लिए किया जाता है.

इसमें उपयोगकर्ता की समीक्षा का एक स्निपेट शामिल होता है. यह स्निपेट, Google Maps में किसी जगह की सुविधाओं के बारे में पूछे गए सवाल का जवाब देता है.

फ़ील्ड

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

समीक्षा का टाइटल.

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

यह Google Maps पर मौजूद उपयोगकर्ता की समीक्षा से जुड़ा लिंक होता है.

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

समीक्षा स्निपेट का आईडी.

start_index integer  (optional)

जवाब के उस सेगमेंट की शुरुआत जिसे इस सोर्स के लिए एट्रिब्यूट किया गया है. इंडेक्स से सेगमेंट की शुरुआत का पता चलता है. इसे बाइट में मापा जाता है.

end_index integer  (optional)

एट्रिब्यूट किए गए सेगमेंट के खत्म होने का समय (अलग से उपलब्ध).

ImageContent

इमेज कॉन्टेंट ब्लॉक.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "image" पर सेट किया जाता है.

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

इमेज का कॉन्टेंट.

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

इमेज का यूआरआई.

mime_type enum (string)  (optional)

इमेज का 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

ऑडियो कॉन्टेंट ब्लॉक.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "audio" पर सेट किया जाता है.

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

ऑडियो कॉन्टेंट.

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

ऑडियो का यूआरआई.

mime_type enum (string)  (optional)

ऑडियो का 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
rate integer  (ज़रूरी नहीं)

ऑडियो का सैंपल रेट.

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

ऑडियो चैनलों की संख्या.

DocumentContent

दस्तावेज़ के कॉन्टेंट का ब्लॉक.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "document" पर सेट किया जाता है.

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

दस्तावेज़ का कॉन्टेंट.

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

दस्तावेज़ का यूआरआई.

mime_type enum (string)  (optional)

दस्तावेज़ का MIME टाइप.

ये वैल्यू हो सकती हैं:

  • application/pdf
VideoContent

वीडियो कॉन्टेंट ब्लॉक.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "video" पर सेट किया जाता है.

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

वीडियो कॉन्टेंट.

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

वीडियो का यूआरआई.

mime_type enum (string)  (optional)

वीडियो का 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

सोच से जुड़ा कॉन्टेंट ब्लॉक.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "thought" पर सेट किया जाता है.

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

बैकएंड सोर्स से मैच करने वाला सिग्नेचर, ताकि उसे जनरेशन में शामिल किया जा सके.

summary ThoughtSummaryContent  (ज़रूरी नहीं)

जवाब की खास जानकारी.

संभावित टाइप

पॉलीमॉर्फ़िक डिसक्रिमिनेटर: type

TextContent

टेक्स्ट कॉन्टेंट वाला ब्लॉक.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "text" पर सेट किया जाता है.

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

ज़रूरी है. टेक्स्ट कॉन्टेंट.

annotations Annotation  (ज़रूरी नहीं)

मॉडल से जनरेट किए गए कॉन्टेंट के लिए उद्धरण की जानकारी.

मॉडल से जनरेट किए गए कॉन्टेंट के लिए उद्धरण की जानकारी.

संभावित टाइप

पॉलीमॉर्फ़िक डिसक्रिमिनेटर: type

UrlCitation

यूआरएल उद्धरण एनोटेशन.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "url_citation" पर सेट किया जाता है.

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

यूआरएल.

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

यूआरएल का टाइटल.

start_index integer  (optional)

जवाब के उस सेगमेंट की शुरुआत जिसे इस सोर्स के लिए एट्रिब्यूट किया गया है. इंडेक्स से सेगमेंट की शुरुआत का पता चलता है. इसे बाइट में मापा जाता है.

end_index integer  (optional)

एट्रिब्यूट किए गए सेगमेंट के खत्म होने का समय (अलग से उपलब्ध).

FileCitation

फ़ाइल के उद्धरण का एनोटेशन.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "file_citation" पर सेट किया जाता है.

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

फ़ाइल का यूआरआई.

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

फ़ाइल का नाम.

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

टेक्स्ट के किसी हिस्से के लिए एट्रिब्यूट किया गया सोर्स.

start_index integer  (optional)

जवाब के उस सेगमेंट की शुरुआत जिसे इस सोर्स के लिए एट्रिब्यूट किया गया है. इंडेक्स से सेगमेंट की शुरुआत का पता चलता है. इसे बाइट में मापा जाता है.

end_index integer  (optional)

एट्रिब्यूट किए गए सेगमेंट के खत्म होने का समय (अलग से उपलब्ध).

PlaceCitation

जगह के उद्धरण का एनोटेशन.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "place_citation" पर सेट किया जाता है.

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

जगह का आईडी, `places/{place_id}` फ़ॉर्मैट में होता है.

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

जगह का टाइटल.

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

जगह का यूआरआई रेफ़रंस.

review_snippets ReviewSnippet  (ज़रूरी नहीं)

समीक्षाओं के ऐसे स्निपेट जिनका इस्तेमाल, Google Maps में किसी जगह की सुविधाओं के बारे में जवाब जनरेट करने के लिए किया जाता है.

इसमें उपयोगकर्ता की समीक्षा का एक स्निपेट शामिल होता है. यह स्निपेट, Google Maps में किसी जगह की सुविधाओं के बारे में पूछे गए सवाल का जवाब देता है.

फ़ील्ड

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

समीक्षा का टाइटल.

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

यह Google Maps पर मौजूद उपयोगकर्ता की समीक्षा से जुड़ा लिंक होता है.

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

समीक्षा स्निपेट का आईडी.

start_index integer  (optional)

जवाब के उस सेगमेंट की शुरुआत जिसे इस सोर्स के लिए एट्रिब्यूट किया गया है. इंडेक्स से सेगमेंट की शुरुआत का पता चलता है. इसे बाइट में मापा जाता है.

end_index integer  (optional)

एट्रिब्यूट किए गए सेगमेंट के खत्म होने का समय (अलग से उपलब्ध).

ImageContent

इमेज कॉन्टेंट ब्लॉक.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "image" पर सेट किया जाता है.

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

इमेज का कॉन्टेंट.

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

इमेज का यूआरआई.

mime_type enum (string)  (optional)

इमेज का 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

फ़ंक्शन टूल कॉल का कॉन्टेंट ब्लॉक.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "function_call" पर सेट किया जाता है.

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

ज़रूरी है. कॉल किए जाने वाले टूल का नाम.

arguments object  (ज़रूरी है)

ज़रूरी है. फ़ंक्शन में पास किए जाने वाले आर्ग्युमेंट.

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

ज़रूरी है. इस टूल कॉल के लिए यूनीक आईडी.

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

बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.

CodeExecutionCallContent

कोड को चलाने से जुड़ा कॉन्टेंट.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "code_execution_call" पर सेट किया जाता है.

arguments CodeExecutionCallArguments  (ज़रूरी है)

ज़रूरी है. कोड को एक्ज़ीक्यूट करने के लिए पास किए जाने वाले आर्ग्युमेंट.

कोड को एक्ज़ीक्यूट करने के लिए, पास किए जाने वाले आर्ग्युमेंट.

फ़ील्ड

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

`code` की प्रोग्रामिंग भाषा.

ये वैल्यू हो सकती हैं:

  • python
code string  (ज़रूरी नहीं)

लागू किया जाने वाला कोड.

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

ज़रूरी है. इस टूल कॉल के लिए यूनीक आईडी.

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

बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.

UrlContextCallContent

यूआरएल के कॉन्टेक्स्ट का कॉन्टेंट.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "url_context_call" पर सेट किया जाता है.

arguments UrlContextCallArguments  (ज़रूरी है)

ज़रूरी है. यूआरएल के कॉन्टेक्स्ट में पास किए जाने वाले आर्ग्युमेंट.

यूआरएल के कॉन्टेक्स्ट में पास किए जाने वाले आर्ग्युमेंट.

फ़ील्ड

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

फ़ेच किए जाने वाले यूआरएल.

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

ज़रूरी है. इस टूल कॉल के लिए यूनीक आईडी.

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

बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.

McpServerToolCallContent

MCPServer टूल कॉल का कॉन्टेंट.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "mcp_server_tool_call" पर सेट किया जाता है.

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

ज़रूरी है. कॉल किए गए टूल का नाम.

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

ज़रूरी है. इस्तेमाल किए गए एमसीपी सर्वर का नाम.

arguments object  (ज़रूरी है)

ज़रूरी है. फ़ंक्शन के लिए आर्ग्युमेंट का JSON ऑब्जेक्ट.

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

ज़रूरी है. इस टूल कॉल के लिए यूनीक आईडी.

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

बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.

GoogleSearchCallContent

Google Search का कॉन्टेंट.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "google_search_call" पर सेट किया जाता है.

arguments GoogleSearchCallArguments  (ज़रूरी है)

ज़रूरी है. Google Search को पास किए जाने वाले आर्ग्युमेंट.

Google Search को पास किए जाने वाले आर्ग्युमेंट.

फ़ील्ड

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

वेब खोज से जुड़ी क्वेरी, ताकि वेब खोज को फ़ॉलो अप किया जा सके.

search_type enum (string)  (optional)

खोज के लिए इस्तेमाल किए गए डेटा का टाइप.

ये वैल्यू हो सकती हैं:

  • web_search
  • image_search
  • enterprise_web_search
id string  (ज़रूरी है)

ज़रूरी है. इस टूल कॉल के लिए यूनीक आईडी.

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

बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.

FileSearchCallContent

फ़ाइल में मौजूद कॉन्टेंट को खोजने की सुविधा.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "file_search_call" पर सेट किया जाता है.

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

ज़रूरी है. इस टूल कॉल के लिए यूनीक आईडी.

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

बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.

GoogleMapsCallContent

Google Maps का कॉन्टेंट.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "google_maps_call" पर सेट किया जाता है.

arguments GoogleMapsCallArguments  (ज़रूरी नहीं)

Google Maps टूल को पास किए जाने वाले तर्क.

Google Maps टूल को पास किए जाने वाले तर्क.

फ़ील्ड

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

वे क्वेरी जिन्हें एक्ज़ीक्यूट करना है.

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

ज़रूरी है. इस टूल कॉल के लिए यूनीक आईडी.

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

बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.

FunctionResultContent

फ़ंक्शन टूल के नतीजे का कॉन्टेंट ब्लॉक.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "function_result" पर सेट किया जाता है.

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

कॉल किए गए टूल का नाम.

is_error boolean  (optional)

टूल कॉल में कोई गड़बड़ी हुई है या नहीं.

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

ज़रूरी है. यह आईडी, फ़ंक्शन कॉल ब्लॉक के आईडी से मेल खाना चाहिए.

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

बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.

result array (FunctionResultSubcontent) or string  (ज़रूरी है)

टूल कॉल का नतीजा.

CodeExecutionResultContent

कोड चलाने के नतीजे का कॉन्टेंट.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "code_execution_result" पर सेट किया जाता है.

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

ज़रूरी है. कोड को चलाने का आउटपुट.

is_error boolean  (optional)

कोड चलाने पर कोई गड़बड़ी हुई है या नहीं.

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

ज़रूरी है. यह आईडी, फ़ंक्शन कॉल ब्लॉक के आईडी से मेल खाना चाहिए.

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

बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.

UrlContextResultContent

यूआरएल के कॉन्टेक्स्ट के हिसाब से मिले नतीजे का कॉन्टेंट.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "url_context_result" पर सेट किया जाता है.

result UrlContextResult  (ज़रूरी है)

ज़रूरी है. यूआरएल के कॉन्टेक्स्ट के नतीजे.

यूआरएल के कॉन्टेक्स्ट का नतीजा.

फ़ील्ड

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

फ़ेच किया गया यूआरएल.

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

यूआरएल को फिर से पाने का स्टेटस.

ये वैल्यू हो सकती हैं:

  • success
  • error
  • paywall
  • unsafe
is_error boolean  (optional)

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

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

ज़रूरी है. यह आईडी, फ़ंक्शन कॉल ब्लॉक के आईडी से मेल खाना चाहिए.

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

बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.

GoogleSearchResultContent

Google Search के नतीजों में दिखने वाला कॉन्टेंट.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "google_search_result" पर सेट किया जाता है.

result GoogleSearchResult  (ज़रूरी है)

ज़रूरी है. Google Search के नतीजे.

Google Search से मिला नतीजा.

फ़ील्ड

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

यह वेब कॉन्टेंट स्निपेट होता है. इसे किसी वेब पेज या ऐप्लिकेशन के वेबव्यू में एम्बेड किया जा सकता है.

is_error boolean  (optional)

इससे पता चलता है कि Google Search में कोई गड़बड़ी हुई है या नहीं.

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

ज़रूरी है. यह आईडी, फ़ंक्शन कॉल ब्लॉक के आईडी से मेल खाना चाहिए.

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

बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.

McpServerToolResultContent

MCPServer टूल के नतीजे का कॉन्टेंट.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "mcp_server_tool_result" पर सेट किया जाता है.

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

उस टूल का नाम जिसे इस टूल कॉल के लिए कॉल किया गया है.

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

इस्तेमाल किए गए एमसीपी सर्वर का नाम.

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

ज़रूरी है. यह आईडी, फ़ंक्शन कॉल ब्लॉक के आईडी से मेल खाना चाहिए.

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

बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.

result array (FunctionResultSubcontent) or string  (ज़रूरी है)

एमसीपी सर्वर कॉल का आउटपुट. यह सामान्य टेक्स्ट या रिच कॉन्टेंट हो सकता है.

FileSearchResultContent

फ़ाइल खोजने के नतीजे का कॉन्टेंट.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "file_search_result" पर सेट किया जाता है.

result FileSearchResult  (ज़रूरी है)

ज़रूरी है. फ़ाइल खोजने के नतीजे.

फ़ाइल खोजने का नतीजा.

फ़ील्ड

custom_metadata array (object)  (ज़रूरी नहीं)

उपयोगकर्ता ने FileSearchResult के बारे में मेटाडेटा दिया है.

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

ज़रूरी है. यह आईडी, फ़ंक्शन कॉल ब्लॉक के आईडी से मेल खाना चाहिए.

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

बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.

GoogleMapsResultContent

Google Maps पर खोज के नतीजों में दिखने वाला कॉन्टेंट.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "google_maps_result" पर सेट किया जाता है.

result GoogleMapsResult  (ज़रूरी है)

ज़रूरी है. Google Maps पर मिले नतीजे.

Google Maps पर खोज के नतीजे.

फ़ील्ड

places Places  (ज़रूरी नहीं)

वे जगहें जो मिलीं.

फ़ील्ड

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

जगह का आईडी, `places/{place_id}` फ़ॉर्मैट में होता है.

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

जगह का टाइटल.

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

जगह का यूआरआई रेफ़रंस.

review_snippets ReviewSnippet  (ज़रूरी नहीं)

समीक्षाओं के ऐसे स्निपेट जिनका इस्तेमाल, Google Maps में किसी जगह की सुविधाओं के बारे में जवाब जनरेट करने के लिए किया जाता है.

इसमें उपयोगकर्ता की समीक्षा का एक स्निपेट शामिल होता है. यह स्निपेट, Google Maps में किसी जगह की सुविधाओं के बारे में पूछे गए सवाल का जवाब देता है.

फ़ील्ड

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

समीक्षा का टाइटल.

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

यह Google Maps पर मौजूद उपयोगकर्ता की समीक्षा से जुड़ा लिंक होता है.

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

समीक्षा स्निपेट का आईडी.

widget_context_token string  (optional)

Google Maps विजेट के कॉन्टेक्स्ट टोकन का संसाधन नाम.

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

ज़रूरी है. यह आईडी, फ़ंक्शन कॉल ब्लॉक के आईडी से मेल खाना चाहिए.

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

बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.

उदाहरण

टेक्स्ट

{
  "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

सुविधा

ऐसा टूल जिसका इस्तेमाल मॉडल कर सकता है.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "function" पर सेट किया जाता है.

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

फ़ंक्शन का नाम.

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

फ़ंक्शन के बारे में जानकारी.

parameters object  (ज़रूरी नहीं)

फ़ंक्शन के पैरामीटर के लिए JSON स्कीमा.

CodeExecution

यह एक ऐसा टूल है जिसका इस्तेमाल मॉडल, कोड को लागू करने के लिए कर सकता है.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "code_execution" पर सेट किया जाता है.

UrlContext

यह एक ऐसा टूल है जिसका इस्तेमाल मॉडल, यूआरएल के कॉन्टेक्स्ट को फ़ेच करने के लिए कर सकता है.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "url_context" पर सेट किया जाता है.

ComputerUse

यह एक ऐसा टूल है जिसका इस्तेमाल मॉडल, कंप्यूटर से इंटरैक्ट करने के लिए कर सकता है.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "computer_use" पर सेट किया जाता है.

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

जिस एनवायरमेंट में कार्रवाई की जा रही है.

ये वैल्यू हो सकती हैं:

  • browser
excludedPredefinedFunctions array (string)  (optional)

पहले से तय किए गए फ़ंक्शन की सूची, जिन्हें मॉडल कॉल से बाहर रखा गया है.

McpServer

MCPServer एक ऐसा सर्वर होता है जिसे मॉडल, कार्रवाइयां करने के लिए कॉल कर सकता है.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "mcp_server" पर सेट किया जाता है.

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

MCPServer का नाम.

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

MCPServer एंडपॉइंट का पूरा यूआरएल. उदाहरण: "https://api.example.com/mcp"

headers object  (ज़रूरी नहीं)

ज़रूरी नहीं: अगर ज़रूरी हो, तो पुष्टि करने वाले हेडर, टाइमआउट वगैरह के लिए फ़ील्ड.

allowed_tools AllowedTools  (ज़रूरी नहीं)

अनुमति वाले टूल.

अनुमति वाले टूल के लिए कॉन्फ़िगरेशन.

फ़ील्ड

mode ToolChoiceType  (ज़रूरी नहीं)

टूल चुनने का मोड.

ये वैल्यू हो सकती हैं:

  • auto
  • any
  • none
  • validated

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

उन टूल के नाम जिन्हें इस्तेमाल करने की अनुमति है.

GoogleSearch

यह एक ऐसा टूल है जिसका इस्तेमाल मॉडल, Google पर खोजने के लिए कर सकता है.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "google_search" पर सेट किया जाता है.

search_types array (enum (string))  (optional)

सर्च के आधार पर जवाब देने की सुविधा के टाइप चालू करने के लिए.

ये वैल्यू हो सकती हैं:

  • web_search
  • image_search
  • enterprise_web_search
FileSearch

यह एक ऐसा टूल है जिसका इस्तेमाल मॉडल, फ़ाइलें खोजने के लिए कर सकता है.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "file_search" पर सेट किया जाता है.

file_search_store_names array (string)  (optional)

फ़ाइल में, खोजने के लिए स्टोर के नाम मौजूद होते हैं.

top_k integer  (optional)

सेमैंटिक तरीके से खोजे गए कितने चंक वापस पाने हैं.

metadata_filter string  (optional)

सिमैंटिक तौर पर जानकारी पाने के लिए इस्तेमाल किए जाने वाले दस्तावेज़ों और चंक पर लागू करने के लिए मेटाडेटा फ़िल्टर.

GoogleMaps

यह एक ऐसा टूल है जिसका इस्तेमाल मॉडल, Google Maps को कॉल करने के लिए कर सकता है.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "google_maps" पर सेट किया जाता है.

enable_widget boolean  (optional)

यह तय करता है कि जवाब के टूल कॉल के नतीजे में, विजेट कॉन्टेक्स्ट टोकन दिखाना है या नहीं.

latitude number  (ज़रूरी नहीं)

उपयोगकर्ता की जगह का अक्षांश.

longitude number  (ज़रूरी नहीं)

उपयोगकर्ता की जगह का देशांतर.

जानकारी पाना

यह एक ऐसा टूल है जिसका इस्तेमाल मॉडल, फ़ाइलों को वापस पाने के लिए कर सकता है.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "retrieval" पर सेट किया जाता है.

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

फ़ाइल वापस पाने की सुविधा चालू करने के लिए, फ़ाइल वापस पाने के तरीके.

ये वैल्यू हो सकती हैं:

  • vertex_ai_search
vertex_ai_search_config VertexAISearchConfig  (optional)

इस कुकी का इस्तेमाल, VertexAISearch के कॉन्फ़िगरेशन के बारे में बताने के लिए किया जाता है.

इस कुकी का इस्तेमाल, VertexAISearch के कॉन्फ़िगरेशन के बारे में बताने के लिए किया जाता है.

फ़ील्ड

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

ज़रूरी नहीं. इस कुकी का इस्तेमाल, Vertex AI Search इंजन के बारे में बताने के लिए किया जाता है.

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

ज़रूरी नहीं. इस कुकी का इस्तेमाल, Vertex AI Search के डेटास्टोर के बारे में बताने के लिए किया जाता है.

उदाहरण

फ़ंक्शन

CodeExecution

UrlContext

ComputerUse

McpServer

GoogleSearch

FileSearch

GoogleMaps

डेटा वापस पाना

इस तरह के अनुरोध का कोई उदाहरण नहीं है.

Turn

फ़ील्ड

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

इस टर्न को शुरू करने वाला. इनपुट के लिए उपयोगकर्ता या मॉडल आउटपुट के लिए मॉडल होना चाहिए.

content array (Content) or string  (ज़रूरी नहीं)

कोई विवरण नहीं दिया गया.

उदाहरण

उपयोगकर्ता की बारी

{
  "role": "user",
  "content": [
    {
      "type": "text",
      "text": "user turn"
    }
  ]
}

मॉडल टर्न

{
  "role": "model",
  "content": [
    {
      "type": "text",
      "text": "model turn"
    }
  ]
}

InteractionSseEvent

संभावित टाइप

पॉलीमॉर्फ़िक डिसक्रिमिनेटर: event_type

InteractionStartEvent

event_type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "interaction.start" पर सेट किया जाता है.

interaction Interaction  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

event_id string  (optional)

इस इवेंट से इंटरैक्शन स्ट्रीम को फिर से शुरू करने के लिए, event_id टोकन का इस्तेमाल किया जाएगा.

InteractionCompleteEvent

event_type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "interaction.complete" पर सेट किया जाता है.

interaction Interaction  (ज़रूरी है)

ज़रूरी है. पेलोड का साइज़ कम करने के लिए, खाली आउटपुट के साथ इंटरैक्शन पूरा किया गया. असली आउटपुट के लिए, ContentDelta इवेंट का इस्तेमाल करें.

event_id string  (optional)

इस इवेंट से इंटरैक्शन स्ट्रीम को फिर से शुरू करने के लिए, event_id टोकन का इस्तेमाल किया जाएगा.

InteractionStatusUpdate

event_type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "interaction.status_update" पर सेट किया जाता है.

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

कोई विवरण नहीं दिया गया.

status enum (string)  (required)

कोई विवरण नहीं दिया गया.

ये वैल्यू हो सकती हैं:

  • in_progress
  • requires_action
  • completed
  • failed
  • cancelled
  • incomplete
event_id string  (optional)

इस इवेंट से इंटरैक्शन स्ट्रीम को फिर से शुरू करने के लिए, event_id टोकन का इस्तेमाल किया जाएगा.

ContentStart

event_type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "content.start" पर सेट किया जाता है.

index integer  (required)

कोई विवरण नहीं दिया गया.

content Content  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

event_id string  (optional)

इस इवेंट से इंटरैक्शन स्ट्रीम को फिर से शुरू करने के लिए, event_id टोकन का इस्तेमाल किया जाएगा.

ContentDelta

event_type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "content.delta" पर सेट किया जाता है.

index integer  (required)

कोई विवरण नहीं दिया गया.

delta ContentDeltaData  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

किसी कॉन्टेंट ब्लॉक के लिए डेल्टा कॉन्टेंट डेटा.

संभावित टाइप

पॉलीमॉर्फ़िक डिसक्रिमिनेटर: type

TextDelta

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "text" पर सेट किया जाता है.

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

कोई विवरण नहीं दिया गया.

ImageDelta

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "image" पर सेट किया जाता है.

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

कोई विवरण नहीं दिया गया.

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

कोई विवरण नहीं दिया गया.

mime_type enum (string)  (optional)

कोई विवरण नहीं दिया गया.

ये वैल्यू हो सकती हैं:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
  • image/gif
  • image/bmp
  • image/tiff
resolution MediaResolution  (ज़रूरी नहीं)

मीडिया का रिज़ॉल्यूशन.

ये वैल्यू हो सकती हैं:

  • low
  • medium
  • high
  • ultra_high

AudioDelta

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "audio" पर सेट किया जाता है.

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

कोई विवरण नहीं दिया गया.

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

कोई विवरण नहीं दिया गया.

mime_type enum (string)  (optional)

कोई विवरण नहीं दिया गया.

ये वैल्यू हो सकती हैं:

  • audio/wav
  • audio/mp3
  • audio/aiff
  • audio/aac
  • audio/ogg
  • audio/flac
  • audio/mpeg
  • audio/m4a
  • audio/l16
  • audio/opus
  • audio/alaw
  • audio/mulaw
rate integer  (ज़रूरी नहीं)

ऑडियो का सैंपल रेट.

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

ऑडियो चैनलों की संख्या.

DocumentDelta

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "document" पर सेट किया जाता है.

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

कोई विवरण नहीं दिया गया.

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

कोई विवरण नहीं दिया गया.

mime_type enum (string)  (optional)

कोई विवरण नहीं दिया गया.

ये वैल्यू हो सकती हैं:

  • application/pdf
VideoDelta

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "video" पर सेट किया जाता है.

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

कोई विवरण नहीं दिया गया.

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

कोई विवरण नहीं दिया गया.

mime_type enum (string)  (optional)

कोई विवरण नहीं दिया गया.

ये वैल्यू हो सकती हैं:

  • 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

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "thought_summary" पर सेट किया जाता है.

content ThoughtSummaryContent  (ज़रूरी नहीं)

विचार में जोड़ने के लिए नई खास जानकारी वाला आइटम.

संभावित टाइप

पॉलीमॉर्फ़िक डिसक्रिमिनेटर: type

TextContent

टेक्स्ट कॉन्टेंट वाला ब्लॉक.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "text" पर सेट किया जाता है.

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

ज़रूरी है. टेक्स्ट कॉन्टेंट.

annotations Annotation  (ज़रूरी नहीं)

मॉडल से जनरेट किए गए कॉन्टेंट के लिए उद्धरण की जानकारी.

मॉडल से जनरेट किए गए कॉन्टेंट के लिए उद्धरण की जानकारी.

संभावित टाइप

पॉलीमॉर्फ़िक डिसक्रिमिनेटर: type

UrlCitation

यूआरएल उद्धरण एनोटेशन.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "url_citation" पर सेट किया जाता है.

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

यूआरएल.

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

यूआरएल का टाइटल.

start_index integer  (optional)

जवाब के उस सेगमेंट की शुरुआत जिसे इस सोर्स के लिए एट्रिब्यूट किया गया है. इंडेक्स से सेगमेंट की शुरुआत का पता चलता है. इसे बाइट में मापा जाता है.

end_index integer  (optional)

एट्रिब्यूट किए गए सेगमेंट के खत्म होने का समय (अलग से उपलब्ध).

FileCitation

फ़ाइल के उद्धरण का एनोटेशन.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "file_citation" पर सेट किया जाता है.

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

फ़ाइल का यूआरआई.

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

फ़ाइल का नाम.

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

टेक्स्ट के किसी हिस्से के लिए एट्रिब्यूट किया गया सोर्स.

start_index integer  (optional)

जवाब के उस सेगमेंट की शुरुआत जिसे इस सोर्स के लिए एट्रिब्यूट किया गया है. इंडेक्स से सेगमेंट की शुरुआत का पता चलता है. इसे बाइट में मापा जाता है.

end_index integer  (optional)

एट्रिब्यूट किए गए सेगमेंट के खत्म होने का समय (अलग से उपलब्ध).

PlaceCitation

जगह के उद्धरण का एनोटेशन.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "place_citation" पर सेट किया जाता है.

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

जगह का आईडी, `places/{place_id}` फ़ॉर्मैट में होता है.

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

जगह का टाइटल.

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

जगह का यूआरआई रेफ़रंस.

review_snippets ReviewSnippet  (ज़रूरी नहीं)

समीक्षाओं के ऐसे स्निपेट जिनका इस्तेमाल, Google Maps में किसी जगह की सुविधाओं के बारे में जवाब जनरेट करने के लिए किया जाता है.

इसमें उपयोगकर्ता की समीक्षा का एक स्निपेट शामिल होता है. यह स्निपेट, Google Maps में किसी जगह की सुविधाओं के बारे में पूछे गए सवाल का जवाब देता है.

फ़ील्ड

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

समीक्षा का टाइटल.

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

यह Google Maps पर मौजूद उपयोगकर्ता की समीक्षा से जुड़ा लिंक होता है.

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

समीक्षा स्निपेट का आईडी.

start_index integer  (optional)

जवाब के उस सेगमेंट की शुरुआत जिसे इस सोर्स के लिए एट्रिब्यूट किया गया है. इंडेक्स से सेगमेंट की शुरुआत का पता चलता है. इसे बाइट में मापा जाता है.

end_index integer  (optional)

एट्रिब्यूट किए गए सेगमेंट के खत्म होने का समय (अलग से उपलब्ध).

ImageContent

इमेज कॉन्टेंट ब्लॉक.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "image" पर सेट किया जाता है.

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

इमेज का कॉन्टेंट.

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

इमेज का यूआरआई.

mime_type enum (string)  (optional)

इमेज का 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

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "thought_signature" पर सेट किया जाता है.

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

बैकएंड सोर्स से मैच करने वाला सिग्नेचर, ताकि उसे जनरेशन में शामिल किया जा सके.

FunctionCallDelta

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "function_call" पर सेट किया जाता है.

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

कोई विवरण नहीं दिया गया.

arguments object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

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

ज़रूरी है. इस टूल कॉल के लिए यूनीक आईडी.

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

बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.

CodeExecutionCallDelta

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "code_execution_call" पर सेट किया जाता है.

arguments CodeExecutionCallArguments  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

कोड को एक्ज़ीक्यूट करने के लिए पास किए जाने वाले आर्ग्युमेंट.

फ़ील्ड

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

`code` की प्रोग्रामिंग भाषा.

ये वैल्यू हो सकती हैं:

  • python
code string  (ज़रूरी नहीं)

लागू किया जाने वाला कोड.

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

ज़रूरी है. इस टूल कॉल के लिए यूनीक आईडी.

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

बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.

UrlContextCallDelta

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "url_context_call" पर सेट किया जाता है.

arguments UrlContextCallArguments  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

यूआरएल के कॉन्टेक्स्ट में पास किए जाने वाले आर्ग्युमेंट.

फ़ील्ड

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

फ़ेच किए जाने वाले यूआरएल.

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

ज़रूरी है. इस टूल कॉल के लिए यूनीक आईडी.

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

बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.

GoogleSearchCallDelta

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "google_search_call" पर सेट किया जाता है.

arguments GoogleSearchCallArguments  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

Google Search को पास किए जाने वाले आर्ग्युमेंट.

फ़ील्ड

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

वेब खोज से जुड़ी क्वेरी, ताकि वेब खोज को फ़ॉलो अप किया जा सके.

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

ज़रूरी है. इस टूल कॉल के लिए यूनीक आईडी.

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

बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.

McpServerToolCallDelta

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "mcp_server_tool_call" पर सेट किया जाता है.

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

कोई विवरण नहीं दिया गया.

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

कोई विवरण नहीं दिया गया.

arguments object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

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

ज़रूरी है. इस टूल कॉल के लिए यूनीक आईडी.

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

बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.

FileSearchCallDelta

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "file_search_call" पर सेट किया जाता है.

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

ज़रूरी है. इस टूल कॉल के लिए यूनीक आईडी.

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

बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.

GoogleMapsCallDelta

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "google_maps_call" पर सेट किया जाता है.

arguments GoogleMapsCallArguments  (ज़रूरी नहीं)

Google Maps टूल को पास किए जाने वाले तर्क.

Google Maps टूल को पास किए जाने वाले तर्क.

फ़ील्ड

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

वे क्वेरी जिन्हें एक्ज़ीक्यूट करना है.

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

ज़रूरी है. इस टूल कॉल के लिए यूनीक आईडी.

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

बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.

FunctionResultDelta

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "function_result" पर सेट किया जाता है.

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

कोई विवरण नहीं दिया गया.

is_error boolean  (optional)

कोई विवरण नहीं दिया गया.

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

ज़रूरी है. यह आईडी, फ़ंक्शन कॉल ब्लॉक के आईडी से मेल खाना चाहिए.

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

बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.

result array (FunctionResultSubcontent) or string  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

CodeExecutionResultDelta

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "code_execution_result" पर सेट किया जाता है.

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

कोई विवरण नहीं दिया गया.

is_error boolean  (optional)

कोई विवरण नहीं दिया गया.

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

ज़रूरी है. यह आईडी, फ़ंक्शन कॉल ब्लॉक के आईडी से मेल खाना चाहिए.

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

बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.

UrlContextResultDelta

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "url_context_result" पर सेट किया जाता है.

result UrlContextResult  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

यूआरएल के कॉन्टेक्स्ट का नतीजा.

फ़ील्ड

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

फ़ेच किया गया यूआरएल.

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

यूआरएल को फिर से पाने का स्टेटस.

ये वैल्यू हो सकती हैं:

  • success
  • error
  • paywall
  • unsafe
is_error boolean  (optional)

कोई विवरण नहीं दिया गया.

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

ज़रूरी है. यह आईडी, फ़ंक्शन कॉल ब्लॉक के आईडी से मेल खाना चाहिए.

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

बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.

GoogleSearchResultDelta

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "google_search_result" पर सेट किया जाता है.

result GoogleSearchResult  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

Google Search से मिला नतीजा.

फ़ील्ड

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

यह वेब कॉन्टेंट स्निपेट होता है. इसे किसी वेब पेज या ऐप्लिकेशन के वेबव्यू में एम्बेड किया जा सकता है.

is_error boolean  (optional)

कोई विवरण नहीं दिया गया.

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

ज़रूरी है. यह आईडी, फ़ंक्शन कॉल ब्लॉक के आईडी से मेल खाना चाहिए.

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

बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.

McpServerToolResultDelta

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "mcp_server_tool_result" पर सेट किया जाता है.

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

कोई विवरण नहीं दिया गया.

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

कोई विवरण नहीं दिया गया.

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

ज़रूरी है. यह आईडी, फ़ंक्शन कॉल ब्लॉक के आईडी से मेल खाना चाहिए.

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

बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.

result array (FunctionResultSubcontent) or string  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

FileSearchResultDelta

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "file_search_result" पर सेट किया जाता है.

result FileSearchResult  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

फ़ाइल खोजने का नतीजा.

फ़ील्ड

custom_metadata array (object)  (ज़रूरी नहीं)

उपयोगकर्ता ने FileSearchResult के बारे में मेटाडेटा दिया है.

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

ज़रूरी है. यह आईडी, फ़ंक्शन कॉल ब्लॉक के आईडी से मेल खाना चाहिए.

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

बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.

GoogleMapsResultDelta

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "google_maps_result" पर सेट किया जाता है.

result GoogleMapsResult  (ज़रूरी नहीं)

Google Maps पर मिले नतीजे.

Google Maps पर खोज के नतीजे.

फ़ील्ड

places Places  (ज़रूरी नहीं)

वे जगहें जो मिलीं.

फ़ील्ड

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

जगह का आईडी, `places/{place_id}` फ़ॉर्मैट में होता है.

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

जगह का टाइटल.

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

जगह का यूआरआई रेफ़रंस.

review_snippets ReviewSnippet  (ज़रूरी नहीं)

समीक्षाओं के ऐसे स्निपेट जिनका इस्तेमाल, Google Maps में किसी जगह की सुविधाओं के बारे में जवाब जनरेट करने के लिए किया जाता है.

इसमें उपयोगकर्ता की समीक्षा का एक स्निपेट शामिल होता है. यह स्निपेट, Google Maps में किसी जगह की सुविधाओं के बारे में पूछे गए सवाल का जवाब देता है.

फ़ील्ड

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

समीक्षा का टाइटल.

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

यह Google Maps पर मौजूद उपयोगकर्ता की समीक्षा से जुड़ा लिंक होता है.

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

समीक्षा स्निपेट का आईडी.

widget_context_token string  (optional)

Google Maps विजेट के कॉन्टेक्स्ट टोकन का संसाधन नाम.

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

ज़रूरी है. यह आईडी, फ़ंक्शन कॉल ब्लॉक के आईडी से मेल खाना चाहिए.

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

बैकएंड की पुष्टि के लिए हस्ताक्षर हैश.

TextAnnotationDelta

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "text_annotation" पर सेट किया जाता है.

annotations Annotation  (ज़रूरी नहीं)

मॉडल से जनरेट किए गए कॉन्टेंट के लिए उद्धरण की जानकारी.

मॉडल से जनरेट किए गए कॉन्टेंट के लिए उद्धरण की जानकारी.

संभावित टाइप

पॉलीमॉर्फ़िक डिसक्रिमिनेटर: type

UrlCitation

यूआरएल उद्धरण एनोटेशन.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "url_citation" पर सेट किया जाता है.

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

यूआरएल.

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

यूआरएल का टाइटल.

start_index integer  (optional)

जवाब के उस सेगमेंट की शुरुआत जिसे इस सोर्स के लिए एट्रिब्यूट किया गया है. इंडेक्स से सेगमेंट की शुरुआत का पता चलता है. इसे बाइट में मापा जाता है.

end_index integer  (optional)

एट्रिब्यूट किए गए सेगमेंट के खत्म होने का समय (अलग से उपलब्ध).

FileCitation

फ़ाइल के उद्धरण का एनोटेशन.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "file_citation" पर सेट किया जाता है.

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

फ़ाइल का यूआरआई.

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

फ़ाइल का नाम.

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

टेक्स्ट के किसी हिस्से के लिए एट्रिब्यूट किया गया सोर्स.

start_index integer  (optional)

जवाब के उस सेगमेंट की शुरुआत जिसे इस सोर्स के लिए एट्रिब्यूट किया गया है. इंडेक्स से सेगमेंट की शुरुआत का पता चलता है. इसे बाइट में मापा जाता है.

end_index integer  (optional)

एट्रिब्यूट किए गए सेगमेंट के खत्म होने का समय (अलग से उपलब्ध).

PlaceCitation

जगह के उद्धरण का एनोटेशन.

type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "place_citation" पर सेट किया जाता है.

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

जगह का आईडी, `places/{place_id}` फ़ॉर्मैट में होता है.

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

जगह का टाइटल.

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

जगह का यूआरआई रेफ़रंस.

review_snippets ReviewSnippet  (ज़रूरी नहीं)

समीक्षाओं के ऐसे स्निपेट जिनका इस्तेमाल, Google Maps में किसी जगह की सुविधाओं के बारे में जवाब जनरेट करने के लिए किया जाता है.

इसमें उपयोगकर्ता की समीक्षा का एक स्निपेट शामिल होता है. यह स्निपेट, Google Maps में किसी जगह की सुविधाओं के बारे में पूछे गए सवाल का जवाब देता है.

फ़ील्ड

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

समीक्षा का टाइटल.

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

यह Google Maps पर मौजूद उपयोगकर्ता की समीक्षा से जुड़ा लिंक होता है.

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

समीक्षा स्निपेट का आईडी.

start_index integer  (optional)

जवाब के उस सेगमेंट की शुरुआत जिसे इस सोर्स के लिए एट्रिब्यूट किया गया है. इंडेक्स से सेगमेंट की शुरुआत का पता चलता है. इसे बाइट में मापा जाता है.

end_index integer  (optional)

एट्रिब्यूट किए गए सेगमेंट के खत्म होने का समय (अलग से उपलब्ध).

event_id string  (optional)

इस इवेंट से इंटरैक्शन स्ट्रीम को फिर से शुरू करने के लिए, event_id टोकन का इस्तेमाल किया जाएगा.

ContentStop

event_type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "content.stop" पर सेट किया जाता है.

index integer  (required)

कोई विवरण नहीं दिया गया.

event_id string  (optional)

इस इवेंट से इंटरैक्शन स्ट्रीम को फिर से शुरू करने के लिए, event_id टोकन का इस्तेमाल किया जाएगा.

ErrorEvent

event_type object  (ज़रूरी है)

कोई विवरण नहीं दिया गया.

इसे हमेशा "error" पर सेट किया जाता है.

error Error  (ज़रूरी नहीं)

कोई विवरण नहीं दिया गया.

किसी इंटरैक्शन से मिला गड़बड़ी का मैसेज.

फ़ील्ड

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

एक यूआरआई, जिससे गड़बड़ी के टाइप की पहचान होती है.

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

इस मैसेज में गड़बड़ी के बारे में ऐसी जानकारी होती है जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है.

event_id string  (optional)

इस इवेंट से इंटरैक्शन स्ट्रीम को फिर से शुरू करने के लिए, 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"
  }
}