इस दस्तावेज़ में, Gemini API के v1 और v1beta वर्शन के बीच के अंतर के बारे में खास जानकारी दी गई है.
- v1: एपीआई का स्टेबल वर्शन. स्टेबल वर्शन में मौजूद सुविधाएं, मेजर वर्शन के पूरे लाइफ़टाइम में पूरी तरह से काम करती हैं. अगर कोई बड़ा बदलाव होता है, तो एपीआई का नया मुख्य वर्शन बनाया जाएगा. साथ ही, मौजूदा वर्शन को कुछ समय बाद बंद कर दिया जाएगा.
एपीआई के मेजर वर्शन में बदलाव किए बिना, एपीआई में ऐसे बदलाव किए जा सकते हैं जिनसे मौजूदा सिस्टम पर कोई असर नहीं पड़ता. Interactions API और इसकी मुख्य सुविधाएं, आम तौर पर
v1में उपलब्ध हैं. - v1beta: इस वर्शन में, शुरुआती सुविधाएं और क्षमताएं शामिल हैं. इन पर अभी काम चल रहा है.
v1betaमें मौजूद सुविधाओं में बदलाव हो सकते हैं. हम मिले सुझावों के आधार पर, इन सुविधाओं को बेहतर बनाते हैं. हालांकि, इससे आपको नई सुविधाओं को स्टेबल वर्शन में प्रमोट किए जाने से पहले ही आज़माने का मौका मिलता है.
सुविधाओं के इस्तेमाल के लिए सहायता
यहां दी गई टेबल में, v1 (GA) और v1beta (बीटा) वर्शन में उपलब्ध सुविधाओं के बारे में बताया गया है. मुख्य एपीआई की सुविधाएं और टूल, Interactions API और generateContent, दोनों पर लागू होते हैं. हालांकि, ऐसा तब तक होता है, जब तक इनके लिए अलग से कुछ तय नहीं किया गया हो:
- - काम करता है
एसडीके में एपीआई का वर्शन कॉन्फ़िगर करना
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",
}'