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

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

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

• - काम करता है
• - इसका इस्तेमाल कभी नहीं किया जा सकेगा

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

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

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)

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();

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."}]
    }]
   }'