Interactions API

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

हालांकि, अब इसे पुराना माना जाता है, लेकिन ओरिजनल generateContent API अब भी पूरी तरह से काम करता है.

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

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

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

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

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

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

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

ऐसे मॉडल और एजेंट जिन पर यह सुविधा काम करती है

मॉडल का नाम टाइप मॉडल आईडी
Gemini 3.1 Flash-Lite मॉडल gemini-3.1-flash-lite
Gemini 3.1 Flash-Lite की झलक मॉडल gemini-3.1-flash-lite-preview
Gemini 3.1 Pro की झलक मॉडल gemini-3.1-pro-preview
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
Lyria 3 Clip की झलक मॉडल lyria-3-clip-preview
Lyria 3 Pro की झलक मॉडल lyria-3-pro-preview
Deep Research की झलक एजेंट deep-research-pro-preview-12-2025
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 पर, यह google-genai पैकेज है. यह वर्शन 1.55.0 से उपलब्ध है.
  • JavaScript पर, यह @google/genai पैकेज है. यह वर्शन 1.33.0 से उपलब्ध है.

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

सीमाएं

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

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

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

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

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