Interactions API

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

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

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

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

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

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

इन गाइडों के माध्यम से इंटरेक्शन एपीआई की विशिष्ट क्षमताओं का अन्वेषण करें. आप इन पृष्ठों पर दिए गए टॉगल का उपयोग करके generateContent और 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 वगैरह शामिल हैं)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

मॉडल का नाम टाइप मॉडल आईडी
Gemini 3.8 Flash मॉडल gemini-3.8-flash
Gemini 3.7 Flash मॉडल gemini-3.7-flash
Gemini 3.6 Flash मॉडल gemini-3.6-flash
Gemini 3.5 Flash मॉडल gemini-3.5-flash
Gemini 3.1 Pro की झलक मॉडल gemini-3.1-pro-preview
Gemini 3.5 Flash-Lite मॉडल gemini-3.5-flash-lite
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.5 की क्लिप की झलक मॉडल lyria-3.5-clip-preview
Lyria 3.5 Pro का प्रीव्यू मॉडल lyria-3.5-pro-preview
Lyria 3 की क्लिप की झलक मॉडल lyria-3-clip-preview
Lyria 3 Pro की झलक मॉडल lyria-3-pro-preview
गहन शोध का पूर्वावलोकन एजेंट deep-research-preview-04-2026
Deep Research की झलक एजेंट deep-research-max-preview-04-2026
एंटीग्रेविटी पूर्वावलोकन एजेंट antigravity-preview-05-2026

एसडीके

इंटरेक्शन एपीआई तक पहुंचने के लिए आप Google GenAI SDK के नवीनतम संस्करण का उपयोग कर सकते हैं.

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

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

सीमाएं

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

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

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

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

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