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

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

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

सुविधाएं और क्षमताएं

यहां दी गई टेबल में, v1 (GA) और v1beta (बीटा) वर्शन में उपलब्ध सुविधाओं के बारे में बताया गया है. मुख्य एपीआई की सुविधाएं और टूल, Interactions API और generateContent, दोनों पर लागू होते हैं. हालांकि, ऐसा तब तक होता है, जब तक कि इनके बारे में कोई और जानकारी न दी गई हो:

• - काम करता है

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

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

from google import genai

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

interaction = client.interactions.create(
    model='gemini-3.6-flash',
    input="Explain how AI works",
)

print(interaction.output_text)

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

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

async function main() {
  const interaction = await ai.interactions.create({
    model: "gemini-3.6-flash",
    input: "Explain how AI works",
  });
  console.log(interaction.output_text);
}

await main();

curl -X POST "https://generativelanguage.googleapis.com/v1/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gemini-3.6-flash",
    "input": "Explain how AI works",
  }'