API সংস্করণ ব্যাখ্যা করা হয়েছে

এই নথিতে জেমিনি এপিআই-এর v1 এবং v1beta সংস্করণগুলোর মধ্যকার পার্থক্যগুলোর একটি সামগ্রিক চিত্র তুলে ধরা হয়েছে।

• v1 : API-এর স্থিতিশীল সংস্করণ। স্থিতিশীল সংস্করণের বৈশিষ্ট্যগুলো প্রধান সংস্করণের জীবনকাল জুড়ে সম্পূর্ণরূপে সমর্থিত থাকে। যদি কোনো ব্রেকিং পরিবর্তন আসে, তাহলে API-এর পরবর্তী প্রধান সংস্করণ তৈরি করা হবে এবং একটি যুক্তিসঙ্গত সময় পরে বিদ্যমান সংস্করণটি বাতিল করা হবে। প্রধান সংস্করণ পরিবর্তন না করেই API-তে নন-ব্রেকিং পরিবর্তন আনা যেতে পারে।
• v1beta : এই সংস্করণে এমন কিছু প্রাথমিক ফিচার অন্তর্ভুক্ত রয়েছে যা এখনও নির্মাণাধীন থাকতে পারে এবং এতে বড় ধরনের পরিবর্তন (breaking changes) আসতে পারে। বিটা সংস্করণের ফিচারগুলো যে স্থিতিশীল সংস্করণে (stable version) আসবে, তারও কোনো নিশ্চয়তা নেই। যদি আপনার প্রোডাকশন পরিবেশে স্থিতিশীলতার প্রয়োজন হয় এবং বড় ধরনের পরিবর্তনের ঝুঁকি নিতে না চান, তবে আপনার প্রোডাকশনে এই সংস্করণটি ব্যবহার করা উচিত নয়।

• - সমর্থিত
• কখনোই সমর্থন করা হবে না

একটি SDK-তে API সংস্করণ কনফিগার করুন

জেমিনি এপিআই এসডিকে-এর ডিফল্ট সংস্করণ হলো 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."}]
    }]
   }'