Gemini API का रेफ़रंस

इस एपीआई रेफ़रंस में, यूनेरी, स्ट्रीमिंग, और रीयल-टाइम एपीआई के बारे में बताया गया है. इनका इस्तेमाल करके, Gemini के मॉडल के साथ इंटरैक्ट किया जा सकता है. REST API का इस्तेमाल किसी भी ऐसे एनवायरमेंट में किया जा सकता है जो एचटीटीपी अनुरोधों के साथ काम करता हो. एपीआई का पहला कॉल करने के लिए, शुरुआती निर्देश देखें. अगर आपको भाषा के हिसाब से हमारी लाइब्रेरी और SDK टूल के रेफ़रंस चाहिए, तो बाईं ओर मौजूद नेविगेशन में SDK टूल के रेफ़रंस में जाकर, उस भाषा के लिंक पर जाएं.

प्राइमरी एंडपॉइंट

Gemini API को इन मुख्य एंडपॉइंट के हिसाब से व्यवस्थित किया गया है:

• इंटरैक्शन (CreateInteraction) (सुझाया गया): Gemini के साथ काम करने के लिए, यह स्टैंडर्ड प्रिमिटिव इस्तेमाल करने का सुझाव दिया जाता है. इसे एजेंटिक वर्कफ़्लो, सर्वर-साइड स्टेट मैनेजमेंट, और जटिल मल्टी-मॉडल, सिलसिलेवार बातचीत के लिए ऑप्टिमाइज़ किया गया है.
• स्टैंडर्ड कॉन्टेंट जनरेशन (generateContent): यह एक स्टैंडर्ड REST एंडपॉइंट है. यह आपके अनुरोध को प्रोसेस करता है और मॉडल के पूरे जवाब को एक ही पैकेज में दिखाता है. यह बिना किसी इंटरैक्शन वाले टास्क के लिए सबसे अच्छा है. इसमें आपको पूरे नतीजे का इंतज़ार करना पड़ सकता है.
• स्ट्रीमिंग कॉन्टेंट जनरेशन (streamGenerateContent): इसमें सर्वर-सेंट इवेंट (एसएसई) का इस्तेमाल किया जाता है. इससे जवाब के छोटे-छोटे हिस्से जनरेट होते ही आपको भेज दिए जाते हैं. इससे चैटबॉट जैसे ऐप्लिकेशन को ज़्यादा तेज़ी से और इंटरैक्टिव तरीके से इस्तेमाल किया जा सकता है.
• Live API (BidiGenerateContent): यह स्टेटफ़ुल WebSocket पर आधारित एपीआई है. इसका इस्तेमाल दोनों दिशाओं में स्ट्रीमिंग के लिए किया जाता है. इसे बातचीत से जुड़े रीयल-टाइम इस्तेमाल के उदाहरणों के लिए डिज़ाइन किया गया है.
• बैच मोड (batchGenerateContent): यह generateContent अनुरोधों के बैच सबमिट करने के लिए, स्टैंडर्ड REST एंडपॉइंट है.
• एम्बेडिंग (embedContent): यह एक स्टैंडर्ड REST एंडपॉइंट है. यह इनपुट Content से टेक्स्ट एम्बेडिंग वेक्टर जनरेट करता है.
• मीडिया जनरेट करने वाले एपीआई: ये ऐसे एंडपॉइंट होते हैं जिनकी मदद से, हमारे खास मॉडल का इस्तेमाल करके मीडिया जनरेट किया जा सकता है. जैसे, इमेज जनरेट करने के लिए Imagen और वीडियो जनरेट करने के लिए Veo. Gemini में ये सुविधाएं भी शामिल हैं. इन्हें generateContent API का इस्तेमाल करके ऐक्सेस किया जा सकता है.
• प्लैटफ़ॉर्म एपीआई: ये यूटिलिटी एंडपॉइंट होते हैं. ये मुख्य सुविधाओं के साथ काम करते हैं. जैसे, फ़ाइलें अपलोड करना और टोकन गिनना.

पुष्टि करना

Gemini API को किए गए सभी अनुरोधों में, x-goog-api-key हेडर के साथ आपका एपीआई पासकोड शामिल होना चाहिए. Google AI Studio में कुछ ही क्लिक में एक नया पासकोड बनाएं.

यहां हेडर में शामिल एपीआई पासकोड के साथ अनुरोध का एक उदाहरण दिया गया है:

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.5-flash:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "Explain how AI works in a few words"
          }
        ]
      }
    ]
  }'

Gemini SDK टूल का इस्तेमाल करके, एपीआई को पासकोड देने के तरीके से जुड़े निर्देशों के लिए, Gemini API के पासकोड इस्तेमाल करना गाइड देखें.