Interactions API

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

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

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

शुरू करें

सुविधा की गाइड

इन गाइड की मदद से, 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 संसाधन बनता है.

सर्वर-साइड पर बातचीत की स्थिति को सेव करने की सुविधा

बातचीत जारी रखने के लिए, previous_interaction_id पैरामीटर का इस्तेमाल करके, बाद के कॉल में पूरे हो चुके इंटरैक्शन के 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 के साथ बैकग्राउंड एक्ज़ीक्यूशन काम नहीं करता. साथ ही, इससे बाद के टर्न के लिए previous_interaction_id का इस्तेमाल नहीं किया जा सकता.

पैसे चुकाकर ली गई सेवा के प्रोजेक्ट के लिए, AI Studio में डेटा के रखरखाव की अवधि कॉन्फ़िगर की जा सकती है, ताकि 7, 14, 28 या 55 दिनों के बाद, प्रोजेक्ट स्टोरेज से लॉग को मिटाने के लिए अपने-आप मार्क किया जा सके. डेटा के रखरखाव की अवधि कम होने पर, पिछली बातचीत को वापस पाने में समस्या आ सकती है.

`delete` तरीके का इस्तेमाल करके, सेव किए गए इंटरैक्शन को किसी भी समय मिटाया जा सकता है. इसके लिए, इंटरैक्शन आईडी की ज़रूरत होती है. AI Studioमें, सेव किए गए इंटरैक्शन के लॉग देखे और मैनेज किए जा सकते हैं. इनमें प्रोजेक्ट स्टोरेज से मिटाने की सुविधा भी शामिल है.

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

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

AI Studio में इंटरैक्शन देखना

एपीआई, पैसे चुकाकर ली गई सेवा के प्रोजेक्ट के लिए, store=true के साथ एक्ज़ीक्यूट किए गए Interactions API के अनुरोधों को सेव करता है. इन्हें Google AI Studio में, लॉग पेज से सीधे देखा जा सकता है. ज़्यादा जानकारी के लिए, लॉग की गाइड देखें.

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

  • कैश हिट रेट: स्टेटफ़ुल और स्टेटलेस, दोनों मोड में इंप्लिसिट कैशिंग की सुविधा उपलब्ध है. ज़्यादा जानकारी के लिए, क्विकस्टार्ट देखें. बातचीत जारी रखने के लिए, 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 Image मॉडल gemini-3-pro-image
Gemini 3.1 Flash Image मॉडल 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 Clip की झलक मॉडल 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 पैकेज है.

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

सीमाएं

  • रिमोट MCP: Gemini 3, रिमोट MCP के साथ काम नहीं करता. यह सुविधा जल्द ही उपलब्ध होगी.
  • सिलसिलेवार बातचीत मॉडल की कंपैटिबिलिटी: बातचीत में अलग-अलग मॉडल (स्टेटफ़ुल या स्टेटलेस) मिक्स करने पर, बाद के मॉडल को इनपुट के तौर पर, पिछले मॉडल के आउटपुट मोड के साथ काम करना होगा. उदाहरण के लिए, अगर gemini-3.1-flash-image का इस्तेमाल करके कोई इमेज जनरेट की जाती है, तो उस बातचीत को ऐसे मॉडल के साथ जारी नहीं रखा जा सकता जो इमेज इनपुट स्वीकार नहीं करता. जैसे, सिर्फ़ टेक्स्ट वाला मॉडल या Lyria जैसा संगीत जनरेट करने वाला मॉडल.

generateContent API, इन सुविधाओं के साथ काम करता है. हालांकि, ये सुविधाएं Interactions API में अब तक उपलब्ध नहीं हैं:

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

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

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