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

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

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

সক্ষমতা এবং বৈশিষ্ট্য সমর্থন

নিম্নলিখিত সারণীতে v1 (GA) এবং v1beta (Beta) জুড়ে সক্ষমতাগুলির উপলব্ধতা বিস্তারিতভাবে বর্ণনা করা হয়েছে। অন্যথায় নির্দিষ্ট করা না থাকলে, কোর এপিআই (Core API) সক্ষমতা এবং টুলগুলি ইন্টারঅ্যাকশন এপিআই (Interactions API) এবং generateContent উভয়ের ক্ষেত্রেই প্রযোজ্য:

• - সমর্থিত

একটি SDK-তে 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",
  }'