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

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

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

सुविधाओं के इस्तेमाल के लिए सहायता

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

सुविधा v1 v1beta
एपीआई की मुख्य सुविधाएं
Interactions API
फ़ंक्शन कॉलिंग
स्ट्रक्चर्ड आउटपुट
सोचने का तरीका / वजह
सिस्टम के लिए निर्देश
ऑडियो आउटपुट (स्पीच कॉन्फ़िगरेशन)
सेवा का टियर (प्राथमिकता / फ़्लेक्स)
टूल
कोड चलाने वाला टूल
Google Search में भरोसेमंद स्रोतों से जानकारी का हवाला देना (Grounding)
Google Maps के भरोसेमंद स्रोतों से जानकारी का हवाला देना (Grounding)
यूआरएल कॉन्टेक्स्ट टूल
फ़ाइल खोजने का टूल
कंप्यूटर इस्तेमाल करने का टूल
एमसीपी सर्वर टूल
रीयलटाइम एपीआई
Live API (WebSockets)
Live Music API
अस्थायी टोकन (Live API)
प्लैटफ़ॉर्म एपीआई
Models API
Files Service Route
File Search Stores Route
Agents API
Webhooks API
कॉन्टेक्स्ट को कैश मेमोरी में सेव करना
  • - काम करता है

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

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

Python

from google import genai

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

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

print(interaction.output_text)

JavaScript

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

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

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

await main();

Java

import com.google.genai.Client;
import com.google.genai.gaos.models.interactions.CreateModelInteraction;
import com.google.genai.gaos.models.interactions.InteractionsInput;
import com.google.genai.gaos.models.interactions.Model;
import com.google.genai.gaos.models.operations.CreateInteractionRequestBody;
import com.google.genai.types.HttpOptions;

Client client = Client.builder()
    .httpOptions(HttpOptions.builder().apiVersion("v1").build())
    .build();

CreateModelInteraction req = CreateModelInteraction.builder()
    .model(Model.of("gemini-3.6-flash"))
    .input(InteractionsInput.of("Explain how AI works"))
    .build();
var interaction = client.interactions.create(CreateInteractionRequestBody.of(req)).interaction().get();
System.out.println(interaction.outputText().orElse(""));

REST

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