Interactions API

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

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

  • सभी ऐप्लिकेशन के लिए यूनिवर्सल इंटरफ़ेस: इसे हर इस्तेमाल के मामले के लिए स्टैंडर्ड इंटरफ़ेस के तौर पर डिज़ाइन किया गया है. इसमें सिंगल-टर्न टेक्स्ट जनरेशन, मल्टीमॉडल अंडरस्टैंडिंग, स्ट्रक्चर्ड आउटपुट, टूल ऑर्केस्ट्रेशन, और एजेंटिक वर्कफ़्लो शामिल हैं.
  • मॉडल और एजेंट के लिए एक ही एपीआई: स्टैंडर्ड Gemini मॉडल के साथ-साथ, सीधे तौर पर खास एजेंट (जैसे, Deep Research और कस्टम मैनेज किए गए एजेंट) को कॉल करने के लिए, एक ही यूनीफ़ाइड एंडपॉइंट और पैटर्न.
  • नई सुविधाएं: सर्वर-साइड पर बातचीत की स्थिति को सेव करने की सुविधाprevious_interaction_id, डीबग करने और यूज़र इंटरफ़ेस रेंडर करने के लिए, एक्ज़ीक्यूशन के चरणों को देखने की सुविधा, और लंबे समय तक चलने वाले टास्क के लिए बैकग्राउंड में एक्ज़ीक्यूट करने की सुविधाbackground=true.
  • कम लागत में ज़्यादा कैश हिट रेट: सिलसिलेवार बातचीत का इस्तेमाल करने पर, सर्वर-साइड पर बातचीत की स्थिति को सेव करने की सुविधा, टर्न के बीच कॉन्टेक्स्ट को ज़्यादा बेहतर तरीके से कैश करने की सुविधा देती है. इससे टोकन की लागत कम हो जाती है.
  • नई सुविधाएं कहां लॉन्च होंगी: आने वाले समय में, सभी नए मॉडल, मल्टीमॉडल क्षमताएं, टूल, और एजेंटिक सुविधाएं, 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.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 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.5 मॉडल lyria-3.5
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 डेवलपर कम्यूनिटी फ़ोरम पर अपने विचार शेयर करें, बग की रिपोर्ट करें या सुविधाओं का अनुरोध करें.

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