Interactions API

Interactions API, हमारा नया इंटरफ़ेस है. साथ ही, Gemini मॉडल और एजेंटों के साथ काम करने का सबसे आसान तरीका है. जून 2026 से, यह सुविधा सभी के लिए उपलब्ध है. साथ ही, सभी नए प्रोजेक्ट के लिए, इस इंटरफ़ेस का इस्तेमाल करने का सुझाव दिया जाता है.

हालांकि, अब इसे लेगसी माना जाता है, लेकिन ओरिजनल generateContent एपीआई का इस्तेमाल अब भी किया जा सकता है.

Interactions API का इस्तेमाल क्यों करना चाहिए?

  • नई सुविधाएं: previous_interaction_id का इस्तेमाल करके, सर्वर-साइड बातचीत की स्थिति को सेव करने की सुविधा. डीबग करने और यूज़र इंटरफ़ेस (यूआई) रेंडर करने के लिए, एक्ज़ीक्यूशन के चरणों को देखने की सुविधा. background=true का इस्तेमाल करके, लंबे समय तक चलने वाले टास्क को बैकग्राउंड में एक्ज़ीक्यूट करने की सुविधा.
  • कैश हिट रेट ज़्यादा होने पर लागत कम होना: सर्वर-साइड स्टेट मैनेजमेंट की मदद से, बातचीत के हर चरण में कॉन्टेक्स्ट को ज़्यादा असरदार तरीके से कैश किया जा सकता है. इससे, सिलसिलेवार बातचीत के लिए टोकन की लागत कम हो जाती है.
  • फ़्रंटियर मॉडल और एजेंट के लिए बनाया गया है: इसे सूझ-बूझ वाले मॉडल, कई चरणों वाले टूल के इस्तेमाल, और मुश्किल गहराई से विश्लेषण वाले फ़्लो के लिए बनाया गया है. इससे एजेंटिक ऐप्लिकेशन बनाने, डीबग करने, और व्यवस्थित करने की प्रोसेस आसान हो जाती है.
  • मॉडल और एजेंट के लिए एक ही एपीआई: Gemini मॉडल और एजेंट को सीधे तौर पर कॉल करने के लिए एक ही यूनीफ़ाइड इंटरफ़ेस, जैसे कि डीप रिसर्च और कस्टम मैनेज किए गए एजेंट. इसके लिए, अलग-अलग एंडपॉइंट या पैटर्न सीखने की ज़रूरत नहीं है.
  • नई सुविधाएं कहाँ लॉन्च होंगी: आने वाले समय में, मुख्य लाइन फ़ैमिली के अलावा अन्य नए मॉडल और सुविधाएँ, Interactions API पर लॉन्च होंगी. साथ ही, एजेंट की नई सुविधाएँ और टूल भी लॉन्च होंगे.

डिफ़ॉल्ट रूप से, Interactions API अनुरोधों को सेव करता है, ताकि previous_interaction_id का इस्तेमाल करके, सर्वर-साइड स्टेट मैनेजमेंट की सुविधाओं का फ़ायदा लिया जा सके. store=false को सेट करके, स्टेटलेस व्यवहार के लिए ऑप्ट इन किया जा सकता है. ज़्यादा जानकारी के लिए, डेटा का रखरखाव सेक्शन देखें.

अपनी प्रोफ़ाइल बनाना शुरू करें

  • कोडिंग एजेंट सेट अप करना: Gemini Docs MCP से कनेक्ट करें और gemini-interactions-api स्किल इंस्टॉल करें. इससे आपके असिस्टेंट को डेवलपर के लिए उपलब्ध नए दस्तावेज़ों और सबसे सही तरीकों का ऐक्सेस मिलेगा. कोडिंग एजेंट सेट अप करना →
  • generateContent से माइग्रेट करें: अगर आपने पहले से ही इंटिग्रेशन किया हुआ है, तो Interactions API पर ट्रांज़िशन करने के लिए, माइग्रेशन गाइड में दिए गए निर्देशों का पालन करें.
  • शुरू करें: Interactions API का इस्तेमाल शुरू करने से जुड़ी गाइड में जाकर, इसका इस्तेमाल शुरू करें.

सुविधाओं के बारे में गाइड

इन गाइड की मदद से, Interactions API की खास सुविधाओं के बारे में जानें. इन पेजों पर मौजूद टॉगल का इस्तेमाल करके, generateContent और Interactions API के बीच स्विच किया जा सकता है:

Interactions API कैसे काम करता है

Interactions API, मुख्य संसाधन Interaction पर आधारित है. Interaction का मतलब है कि बातचीत या टास्क पूरा हो गया है. यह सेशन रिकॉर्ड के तौर पर काम करता है. इसमें इंटरैक्शन का पूरा इतिहास, एक्ज़ीक्यूशन के चरणों के क्रम के तौर पर शामिल होता है. इन चरणों में मॉडल के सुझाव, सर्वर-साइड या क्लाइंट-साइड टूल कॉल और नतीजे (जैसे, function_call और function_result) और फ़ाइनल model_output शामिल हैं. स्टोर किए गए संसाधन (interactions.get के ज़रिए वापस पाया गया) में, पूरे कॉन्टेक्स्ट के लिए user_input चरण भी शामिल होते हैं. हालांकि, interactions.create जवाब में सिर्फ़ मॉडल से जनरेट किए गए चरण शामिल होते हैं.

interactions.create पर कॉल करने का मतलब है कि आपने एक नई Interaction रिसॉर्स बनाई है.

सर्वर-साइड स्टेट मैनेजमेंट

बातचीत जारी रखने के लिए, id पैरामीटर का इस्तेमाल करके, पूरी हो चुकी बातचीत के id का इस्तेमाल किया जा सकता है.previous_interaction_id सर्वर इस आईडी का इस्तेमाल, बातचीत का इतिहास वापस पाने के लिए करता है. इससे आपको चैट का पूरा इतिहास फिर से भेजने की ज़रूरत नहीं पड़ती.

previous_interaction_id पैरामीटर, सिर्फ़ बातचीत के इतिहास (इनपुट और आउटपुट) को सेव करता है. इसके लिए, previous_interaction_id का इस्तेमाल किया जाता है. अन्य पैरामीटर इंटरैक्शन के स्कोप वाले पैरामीटर होते हैं. ये सिर्फ़ उस इंटरैक्शन पर लागू होते हैं जिसे अभी जनरेट किया जा रहा है:

  • tools
  • system_instruction
  • generation_config (इसमें thinking_level, temperature वगैरह शामिल हैं)

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

डेटा स्टोरेज और रखरखाव

डिफ़ॉल्ट रूप से, एपीआई सभी इंटरैक्शन ऑब्जेक्ट (store=true) को सेव करता है, ताकि सर्वर-साइड स्टेट मैनेजमेंट की सुविधाओं (previous_interaction_id के साथ), बैकग्राउंड में एक्ज़ीक्यूशन (background=true का इस्तेमाल करके), और निगरानी के मकसद से इनका इस्तेमाल आसान हो सके.

  • पैसे चुकाकर ली जाने वाली सदस्यता: सिस्टम, इंटरैक्शन को 55 दिनों तक सेव रखता है.
  • फ़्री टियर: सिस्टम, इंटरैक्शन को एक दिन तक सेव रखता है.

अगर आपको ऐसा नहीं करना है, तो अपने अनुरोध में store=false सेट करें. यह कंट्रोल, स्टेट मैनेजमेंट से अलग है. आपके पास किसी भी इंटरैक्शन के लिए स्टोरेज से ऑप्ट आउट करने का विकल्प होता है. हालांकि, ध्यान दें कि store=false, background=true के साथ काम नहीं करता. साथ ही, यह बाद के टर्न के लिए previous_interaction_id का इस्तेमाल करने से रोकता है.

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

डेटा के रखरखाव की अवधि खत्म होने के बाद, आपका डेटा अपने-आप मिट जाएगा.

सिस्टम, शर्तों के मुताबिक इंटरैक्शन ऑब्जेक्ट को प्रोसेस करता है.

सबसे सही तरीके

  • कैश हिट रेट: बातचीत जारी रखने के लिए previous_interaction_id का इस्तेमाल करने से, सिस्टम को बातचीत के इतिहास के लिए इंप्लिसिट कैशिंग का इस्तेमाल करने में आसानी होती है. इससे परफ़ॉर्मेंस बेहतर होती है और लागत कम होती है.
  • एजेंट और मॉडल के साथ इंटरैक्शन को मिक्स करना: आपके पास बातचीत के दौरान, एजेंट और मॉडल के साथ इंटरैक्शन को मिक्स और मैच करने का विकल्प होता है. उदाहरण के लिए, शुरुआती डेटा इकट्ठा करने के लिए, Deep Research एजेंट जैसे किसी खास एजेंट का इस्तेमाल किया जा सकता है. इसके बाद, फ़ॉलो-अप टास्क के लिए, Gemini के स्टैंडर्ड मॉडल का इस्तेमाल किया जा सकता है. जैसे, खास जानकारी देना या फ़ॉर्मैट बदलना. इन चरणों को previous_interaction_id से लिंक किया जा सकता है.

काम करने वाले मॉडल और एजेंट

मॉडल का नाम टाइप मॉडल आईडी
Gemini 3.5 Flash मॉडल gemini-3.5-flash
Gemini 3.1 Pro की झलक मॉडल gemini-3.1-pro-preview
Gemini 3.1 Flash-Lite मॉडल gemini-3.1-flash-lite
Gemini 3 Flash की झलक मॉडल gemini-3-flash-preview
Gemini 2.5 Pro मॉडल gemini-2.5-pro
Gemini 2.5 Flash मॉडल gemini-2.5-flash
Gemini 2.5 Flash-lite मॉडल gemini-2.5-flash-lite
Gemini 3 Pro की इमेज मॉडल gemini-3-pro-image
Gemini 3.1 Flash की इमेज मॉडल gemini-3.1-flash-image
Gemini 3.1 Flash TTS की झलक मॉडल gemini-3.1-flash-tts-preview
Gemma 4 31B IT मॉडल gemma-4-31b-it
Gemma 4 26B MoE IT मॉडल gemma-4-26b-a4b-it
Lyria 3 की क्लिप की झलक मॉडल lyria-3-clip-preview
Lyria 3 Pro की झलक मॉडल lyria-3-pro-preview
Deep Research की झलक एजेंट deep-research-preview-04-2026
Deep Research की झलक एजेंट deep-research-max-preview-04-2026
Antigravity की झलक एजेंट antigravity-preview-05-2026

एसडीके

Interactions API को ऐक्सेस करने के लिए, Google GenAI SDK टूल के नए वर्शन का इस्तेमाल किया जा सकता है.

  • Python में, यह 2.3.0 वर्शन से google-genai पैकेज है.
  • JavaScript पर, यह 2.3.0 वर्शन से @google/genai पैकेज है.

लाइब्रेरी पेज पर जाकर, एसडीके इंस्टॉल करने के तरीके के बारे में ज़्यादा जानें.

सीमाएं

  • रिमोट एमसीपी: Gemini 3 में रिमोट एमसीपी की सुविधा काम नहीं करती. यह सुविधा जल्द ही उपलब्ध होगी.

नीचे दी गई सुविधाएं, generateContent एपीआई के साथ काम करती हैं. हालांकि, ये सुविधाएं फ़िलहाल Interactions API में उपलब्ध नहीं हैं:

सुझाव/राय दें या शिकायत करें

Interactions API को बेहतर बनाने के लिए, आपका सुझाव/राय या शिकायत हमारे लिए अहम है. अपने विचार शेयर करें, बग की शिकायत करें या हमारी Google AI डेवलपर कम्यूनिटी फ़ोरम पर सुविधाओं का अनुरोध करें.

आगे क्या करना है