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

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

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

किसी एसडीके में एपीआई का वर्शन कॉन्फ़िगर करना

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

Python

from google import genai

client = genai.Client(http_options={'api_version': 'v1alpha'})

response = client.models.generate_content(
    model='gemini-2.0-flash',
    contents="Explain how AI works",
)

print(response.text)

JavaScript

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({
  httpOptions: { apiVersion: "v1alpha" },
});

async function main() {
  const response = await ai.models.generateContent({
    model: "gemini-2.0-flash",
    contents: "Explain how AI works",
  });
  console.log(response.text);
}

await main();

REST

curl "https://generativelanguage.googleapis.com/v1/models/gemini-1.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."}]
    }]
   }'