Gemini API का रेफ़रंस

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

मुख्य एंडपॉइंट

Gemini API को इन मुख्य एंडपॉइंट के हिसाब से ऑर्गनाइज़ किया गया है:

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