एपीआई वर्शन के बारे में जानकारी

इस दस्तावेज़ में, Gemini API के v1 और v1beta वर्शन के बीच के अंतर के बारे में खास जानकारी दी गई है.

  • v1: एपीआई का स्टैबल वर्शन. स्टेबल वर्शन में मौजूद सुविधाएं, मेजर वर्शन के पूरे लाइफ़साइकल के दौरान पूरी तरह से काम करती हैं. अगर कोई ऐसा बदलाव होता है जिससे एपीआई के काम करने का तरीका बदल जाता है, तो एपीआई का नया वर्शन बनाया जाएगा. साथ ही, कुछ समय बाद मौजूदा वर्शन बंद कर दिया जाएगा. मेजर वर्शन में बदलाव किए बिना, एपीआई में ऐसे बदलाव किए जा सकते हैं जिनसे कोई समस्या नहीं होती.
  • v1beta: इस वर्शन में, रिलीज़ होने से पहले ऐक्सेस की सुविधाएं शामिल हैं. ये सुविधाएं अभी डेवलप की जा रही हैं और इनमें तेज़ी से बदलाव हो सकते हैं. इस बात की भी कोई गारंटी नहीं है कि बीटा वर्शन की सुविधाएं, स्टेबल वर्शन में उपलब्ध होंगी. इस अस्थिरता की वजह से, आपको इस वर्शन के साथ प्रोडक्शन ऐप्लिकेशन लॉन्च नहीं करने चाहिए.
सुविधा v1 v1beta
कॉन्टेंट जनरेट करें - सिर्फ़ टेक्स्ट वाला इनपुट
कॉन्टेंट जनरेट करना - टेक्स्ट और इमेज इनपुट
कॉन्टेंट जनरेट करना - टेक्स्ट आउटपुट
कॉन्टेंट जनरेट करना - एक से ज़्यादा बार की जाने वाली बातचीत (चैट)
कॉन्टेंट जनरेट करना - फ़ंक्शन कॉल
कॉन्टेंट जनरेट करना - स्ट्रीमिंग
कॉन्टेंट एम्बेड करना - सिर्फ़ टेक्स्ट वाला इनपुट
जवाब जनरेट करें
सिमेंटिक रिट्रीवर
  • - काम करता है
  • - कभी भी काम नहीं करेगा

SDK टूल में एपीआई वर्शन कॉन्फ़िगर करना

Gemini API SDK का डिफ़ॉल्ट वर्शन v1beta होता है. हालांकि, यहां दिए गए कोड सैंपल में दिखाए गए तरीके से एपीआई वर्शन सेट करके, v1 का इस्तेमाल किया जा सकता है:

Python

Python SDK टूल google.generativeai, v1beta का इस्तेमाल करता है और एपीआई वर्शन को स्विच करने का तरीका नहीं देता.

लो-लेवल Python क्लाइंट लाइब्रेरी, google.ai.generativelanguage दूसरे वर्शन को अलग-अलग मॉड्यूल के तौर पर दिखाती है: google.ai.generativelanguage_v1 और google.ai.generativelanguage_v1beta. डिफ़ॉल्ट रूप से, यह v1beta पर सेट होता है.

import google.ai.generativelanguage_v1 as glm

client = glm.GenerativeServiceClient(
    client_options=dict(api_key=YOUR_API_KEY))

response = client.generate_content({
  "model": "models/gemini-1.5-flash",
  "contents": [ {"parts": [ {"text": "Explain how AI works"}]}]
})

print(type(response).to_dict(response))

Node.js

const { GoogleGenerativeAI } = require("@google/generative-ai");

const genAI = new GoogleGenerativeAI("YOUR_API_KEY");
const model = genAI.getGenerativeModel({ model: 'gemini-1.5-flash' }, { apiVersion: 'v1' });

const prompt = "Explain how AI works";

const result = await model.generateContent(prompt);
console.log(result.response.text());

REST

curl "https://generativelanguage.googleapis.com/v1/models/gemini-1.5-flash:generateContent?key=YOUR_API_KEY" \
-H 'Content-Type: application/json' \
-X POST \
-d '{
  "contents": [{
    "parts":[{"text": "Write a story about a magic backpack."}]
    }]
   }'