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

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

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

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

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

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

from google import genai

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

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

print(response.text)

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

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

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

await main();

curl "https://generativelanguage.googleapis.com/v1/models/gemini-3-flash-preview:generateContent" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H 'Content-Type: application/json' \
-X POST \
-d '{
  "contents": [{
    "parts":[{"text": "Explain how AI works."}]
    }]
   }'