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

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

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

• - काम करता है
• - कभी भी काम नहीं करेगा

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

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

from google import genai

client = genai.Client(api_key="YOUR_API_KEY",
                      http_options={'api_version': 'v1alpha'})

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

print(response.text)

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

const ai = new GoogleGenAI({
  apiKey: "YOUR_API_KEY",
  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();

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": "Explain how AI works."}]
    }]
   }'