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

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

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

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

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

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

from google import genai

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

interaction = client.interactions.create(
    model='gemini-3.5-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.5-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.5-flash",
    "input": "Explain how AI works"
  }'