Gemini API

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

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

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

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

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

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

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

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

इंटरैक्शन जनरेट करने के लिए इस्तेमाल किए गए `Model` का नाम.
अगर `agent` नहीं दिया गया है, तो यह प्रॉपर्टी ज़रूरी है.

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

  • 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

    यह तर्क करने वाला हमारा सबसे नया SOTA मॉडल है. इसमें पहले से ज़्यादा बारीकी से और गहराई से जानकारी मिलती है. साथ ही, यह मल्टीमॉडल इनपुट को बेहतर तरीके से समझता है और कोडिंग से जुड़ी इसकी क्षमताएँ भी बेहतर हैं.

  • gemini-3.1-flash-image-preview

    तेज़ी से काम करने की क्षमता और असलियत के हिसाब से इमेज जनरेट करने की सुविधाओं के साथ, प्रो-लेवल की विज़ुअल इंटेलिजेंस.

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

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

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

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

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

    Gemini Deep Research 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 एजेंट के लिए कॉन्फ़िगरेशन.

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

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

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

  • auto
  • none

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

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

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

previous_interaction_id string  (optional)

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

response_modalities ResponseModality  (optional)

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

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

  • text
  • image
  • audio

जवाब

यह 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 संसाधन दिखाता है.

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

    यह तर्क करने वाला हमारा सबसे नया SOTA मॉडल है. इसमें पहले से ज़्यादा बारीकी से और गहराई से जानकारी मिलती है. साथ ही, यह मल्टीमॉडल इनपुट को बेहतर तरीके से समझता है और कोडिंग से जुड़ी इसकी क्षमताएँ भी बेहतर हैं.

  • gemini-3.1-flash-image-preview

    तेज़ी से काम करने की क्षमता और असलियत के हिसाब से इमेज जनरेट करने की सुविधाओं के साथ, प्रो-लेवल की विज़ुअल इंटेलिजेंस.

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

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

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

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

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

    Gemini Deep Research 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

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

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

total_cached_tokens integer  (optional)

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

cached_tokens_by_modality ModalityTokens  (optional)

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

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

फ़ील्ड

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

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

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

  • text
  • image
  • audio

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

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

total_output_tokens integer  (optional)

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

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

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

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

फ़ील्ड

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

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

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

  • text
  • image
  • audio

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

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

total_tool_use_tokens integer  (optional)

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

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

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

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

फ़ील्ड

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

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

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

  • text
  • image
  • audio

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

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

total_thought_tokens integer  (optional)

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

total_tokens integer  (optional)

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

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

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

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

  • text
  • image
  • audio

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

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

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

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

previous_interaction_id string  (optional)

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

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

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

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

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

संभावित टाइप

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

DynamicAgentConfig

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

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

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

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

DeepResearchAgentConfig

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

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

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

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

  • auto
  • none

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

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

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

उदाहरण

उदाहरण

{
  "created": "2025-12-04T15:01:45Z",
  "id": "v1_ChdXS0l4YWZXTk9xbk0xZThQczhEcmlROBIXV0tJeGFmV05PcW5NMWU4UHM4RHJpUTg",
  "model": "gemini-3-flash-preview",
  "object": "interaction",
  "outputs": [
    {
      "text": "Hello! I'm doing well, functioning as expected. Thank you for asking! How are you doing today?",
      "type": "text"
    }
  ],
  "role": "model",
  "status": "completed",
  "updated": "2025-12-04T15:01:45Z",
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 7
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 7,
    "total_output_tokens": 23,
    "total_thought_tokens": 49,
    "total_tokens": 79,
    "total_tool_use_tokens": 0
  }
}

डेटा मॉडल

सामग्री

जवाब का कॉन्टेंट.

संभावित टाइप

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

TextContent

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

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

टेक्स्ट कॉन्टेंट.

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

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

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

संभावित टाइप

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

UrlCitation

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

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

यूआरएल.

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

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

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

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

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

start_index integer  (optional)

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

end_index integer  (optional)

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

FileCitation

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

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

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

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

फ़ाइल का नाम.

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

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

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

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

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

start_index integer  (optional)

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

end_index integer  (optional)

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

PlaceCitation

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

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  (ज़रूरी नहीं)

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

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

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

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

start_index integer  (optional)

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

end_index integer  (optional)

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

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

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

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

ImageContent

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

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

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

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

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

mime_type enum (string)  (optional)

इमेज का MIME टाइप.

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

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

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

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

  • low
  • medium
  • high
  • ultra_high

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

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

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

AudioContent

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

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

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

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

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

mime_type enum (string)  (optional)

ऑडियो का MIME टाइप.

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

  • audio/wav
  • audio/mp3
  • audio/aiff
  • audio/aac
  • audio/ogg
  • audio/flac
type object  (ज़रूरी है)

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

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

DocumentContent

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

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

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

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

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

mime_type enum (string)  (optional)

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

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

  • application/pdf
type object  (ज़रूरी है)

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

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

VideoContent

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

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

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

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

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

ThoughtContent

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

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

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

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

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

संभावित टाइप

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

TextContent

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

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

टेक्स्ट कॉन्टेंट.

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

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

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

संभावित टाइप

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

UrlCitation

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

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

यूआरएल.

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

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

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

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

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

start_index integer  (optional)

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

end_index integer  (optional)

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

FileCitation

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

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

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

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

फ़ाइल का नाम.

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

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

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

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

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

start_index integer  (optional)

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

end_index integer  (optional)

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

PlaceCitation

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

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  (ज़रूरी नहीं)

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

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

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

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

start_index integer  (optional)

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

end_index integer  (optional)

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

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

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

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

ImageContent

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

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

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

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

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

mime_type enum (string)  (optional)

इमेज का MIME टाइप.

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

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

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

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

  • low
  • medium
  • high
  • ultra_high

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

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

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

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

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

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

FunctionCallContent

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

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

कॉल किए जाने वाले टूल का नाम.

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

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

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

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

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

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

इस टूल कॉल के लिए यूनीक आईडी.

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

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

FunctionResultContent

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

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

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

is_error boolean  (optional)

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

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

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

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

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

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

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

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

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

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

CodeExecutionCallContent

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

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

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

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

फ़ील्ड

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

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

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

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

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

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

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

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

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

इस टूल कॉल के लिए यूनीक आईडी.

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

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

CodeExecutionResultContent

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

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

कोड को चलाने का आउटपुट.

is_error boolean  (optional)

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

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

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

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

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

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

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

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

UrlContextCallContent

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

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

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

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

फ़ील्ड

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

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

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

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

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

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

इस टूल कॉल के लिए यूनीक आईडी.

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

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

UrlContextResultContent

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

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

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

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

फ़ील्ड

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

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

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

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

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

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

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

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

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

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

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

यह आईडी, यूआरएल कॉन्टेक्स्ट कॉल ब्लॉक के आईडी से मेल खाना चाहिए.

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

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

GoogleSearchCallContent

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

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

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

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

फ़ील्ड

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

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

search_type enum (string)  (optional)

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

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

  • web_search
  • image_search
type object  (ज़रूरी है)

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

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

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

इस टूल कॉल के लिए यूनीक आईडी.

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

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

GoogleSearchResultContent

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

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

Google Search के नतीजे.

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

फ़ील्ड

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

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

is_error boolean  (optional)

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

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

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

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

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

यह आईडी, Google Search पर कॉल ब्लॉक करने की सुविधा के आईडी से मेल खाना चाहिए.

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

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

McpServerToolCallContent

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

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

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

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

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

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

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

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

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

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

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

इस टूल कॉल के लिए यूनीक आईडी.

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

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

McpServerToolResultContent

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

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

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

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

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

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

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

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

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

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

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

यह आईडी, एमसीपी सर्वर टूल कॉल ब्लॉक के आईडी से मेल खाना चाहिए.

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

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

FileSearchCallContent

फ़ाइल में मौजूद कॉन्टेंट को खोजें.

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

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

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

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

इस टूल कॉल के लिए यूनीक आईडी.

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

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

FileSearchResultContent

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

result FileSearchResult  (ज़रूरी नहीं)

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

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

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

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

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

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

यह आईडी, फ़ाइल खोजने के लिए किए गए कॉल ब्लॉक के आईडी से मेल खाना चाहिए.

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

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

GoogleMapsCallContent

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

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

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

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

फ़ील्ड

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

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

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

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

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

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

इस टूल कॉल के लिए यूनीक आईडी.

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

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

GoogleMapsResultContent

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

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 विजेट के कॉन्टेक्स्ट टोकन का संसाधन नाम.

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

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

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

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

यह आईडी, Google Maps पर कॉल ब्लॉक करने की सुविधा के आईडी से मेल खाना चाहिए.

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": "function_result",
  "name": "get_weather",
  "call_id": "gth23981",
  "result": [
    {
      "type": "text",
      "text": "{\"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"
}

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

{
  "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_call",
  "id": "call_123456"
}

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

{
  "type": "file_search_result",
  "call_id": "call_123456",
  "result": [
    {
      "text": "search result chunk",
      "file_search_store": "file_search_store"
    }
  ]
}

Google Maps Call

{
  "type": "google_maps_call",
  "id": "call_123456",
  "arguments": {
    "query": "best food near me"
  }
}

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

सुविधा

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

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

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

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

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

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

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

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

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

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

GoogleSearch

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

search_types array (enum (string))  (optional)

खोज के लिए, किस तरह की ग्राउंडिंग चालू करनी है.

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

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

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

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

CodeExecution

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

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

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

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

UrlContext

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

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

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

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

ComputerUse

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

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

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

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

  • browser
excludedPredefinedFunctions array (string)  (optional)

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

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

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

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

McpServer

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

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)  (ज़रूरी नहीं)

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

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

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

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

FileSearch

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

file_search_store_names array (string)  (optional)

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

top_k integer  (optional)

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

metadata_filter string  (optional)

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

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

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

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

GoogleMaps

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

enable_widget boolean  (optional)

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

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

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

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

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

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

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

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

उदाहरण

फ़ंक्शन

GoogleSearch

CodeExecution

UrlContext

ComputerUse

McpServer

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

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

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

event_type enum (string)  (required)

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

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

  • interaction.start
event_id string  (optional)

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

InteractionCompleteEvent

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

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

event_type enum (string)  (required)

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

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

  • interaction.complete
event_id string  (optional)

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

InteractionStatusUpdate

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

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

status enum (string)  (required)

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

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

  • in_progress
  • requires_action
  • completed
  • failed
  • cancelled
  • incomplete
event_type string  (ज़रूरी है)

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

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

event_id string  (optional)

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

ContentStart

index integer  (required)

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

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

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

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

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

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

event_id string  (optional)

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

ContentDelta

index integer  (required)

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

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

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

संभावित टाइप

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

TextDelta

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

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

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

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

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

संभावित टाइप

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

UrlCitation

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

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

यूआरएल.

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

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

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

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

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

start_index integer  (optional)

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

end_index integer  (optional)

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

FileCitation

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

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

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

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

फ़ाइल का नाम.

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

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

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

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

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

start_index integer  (optional)

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

end_index integer  (optional)

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

PlaceCitation

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

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  (ज़रूरी नहीं)

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

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

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

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

start_index integer  (optional)

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

end_index integer  (optional)

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

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

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

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

ImageDelta

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

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

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

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

mime_type enum (string)  (optional)

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

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

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

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

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

  • low
  • medium
  • high
  • ultra_high

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

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

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

AudioDelta

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

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

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

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

mime_type enum (string)  (optional)

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

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

  • audio/wav
  • audio/mp3
  • audio/aiff
  • audio/aac
  • audio/ogg
  • audio/flac
type object  (ज़रूरी है)

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

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

DocumentDelta

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

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

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

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

mime_type enum (string)  (optional)

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

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

  • application/pdf
type object  (ज़रूरी है)

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

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

VideoDelta

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

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

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

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

ThoughtSummaryDelta

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

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

संभावित टाइप

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

TextContent

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

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

टेक्स्ट कॉन्टेंट.

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

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

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

संभावित टाइप

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

UrlCitation

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

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

यूआरएल.

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

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

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

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

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

start_index integer  (optional)

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

end_index integer  (optional)

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

FileCitation

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

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

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

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

फ़ाइल का नाम.

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

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

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

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

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

start_index integer  (optional)

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

end_index integer  (optional)

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

PlaceCitation

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

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  (ज़रूरी नहीं)

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

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

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

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

start_index integer  (optional)

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

end_index integer  (optional)

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

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

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

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

ImageContent

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

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

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

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

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

mime_type enum (string)  (optional)

इमेज का MIME टाइप.

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

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

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

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

  • low
  • medium
  • high
  • ultra_high

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

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

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

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

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

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

ThoughtSignatureDelta

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

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

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

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

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

FunctionCallDelta

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

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

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

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

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

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

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

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

इस टूल कॉल के लिए यूनीक आईडी.

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

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

FunctionResultDelta

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

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

is_error boolean  (optional)

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

result object या string  (ज़रूरी है)

टूल कॉल के नतीजे में अंतर.

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

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

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

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

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

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

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

CodeExecutionCallDelta

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

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

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

फ़ील्ड

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

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

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

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

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

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

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

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

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

इस टूल कॉल के लिए यूनीक आईडी.

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

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

CodeExecutionResultDelta

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

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

is_error boolean  (optional)

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

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

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

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

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

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

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

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

UrlContextCallDelta

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

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

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

फ़ील्ड

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

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

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

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

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

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

इस टूल कॉल के लिए यूनीक आईडी.

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

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

UrlContextResultDelta

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

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

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

फ़ील्ड

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

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

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

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

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

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

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

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

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

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

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

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

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

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

GoogleSearchCallDelta

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

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

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

फ़ील्ड

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

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

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

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

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

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

इस टूल कॉल के लिए यूनीक आईडी.

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

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

GoogleSearchResultDelta

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

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

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

फ़ील्ड

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

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

is_error boolean  (optional)

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

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

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

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

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

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

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

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

McpServerToolCallDelta

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

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

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

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

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

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

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

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

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

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

इस टूल कॉल के लिए यूनीक आईडी.

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

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

McpServerToolResultDelta

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

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

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

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

result object या string  (ज़रूरी है)

टूल कॉल के नतीजे में अंतर.

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

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

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

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

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

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

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

FileSearchCallDelta

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

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

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

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

इस टूल कॉल के लिए यूनीक आईडी.

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

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

FileSearchResultDelta

result FileSearchResult  (ज़रूरी नहीं)

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

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

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

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

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

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

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

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

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

GoogleMapsCallDelta

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

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

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

फ़ील्ड

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

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

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

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

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

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

इस टूल कॉल के लिए यूनीक आईडी.

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

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

GoogleMapsResultDelta

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 विजेट के कॉन्टेक्स्ट टोकन का संसाधन नाम.

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

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

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

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

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

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

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

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

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

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

event_id string  (optional)

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

ContentStop

index integer  (required)

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

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

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

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

event_id string  (optional)

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

ErrorEvent

error Error  (ज़रूरी नहीं)

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

किसी इंटरैक्शन से मिला गड़बड़ी का मैसेज.

फ़ील्ड

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

यह यूआरआई, गड़बड़ी के टाइप की पहचान करता है.

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

इस मैसेज में गड़बड़ी के बारे में ऐसी जानकारी होती है जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है.

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

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

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

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