Interactions API

Interactions API, Gemini के मॉडल और एजेंट के साथ काम करने का सबसे आसान और बेहतर तरीका है. जून 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.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 पैकेज है.

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

सीमाएं

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

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

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

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

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