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

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

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

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

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