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 উভয়ের ক্ষেত্রেই প্রযোজ্য:

বৈশিষ্ট্য v1 v1beta
কোর এপিআই ক্ষমতা
ইন্টারঅ্যাকশন এপিআই
ফাংশন কলিং
কাঠামোগত আউটপুট
চিন্তা / যুক্তি
সিস্টেম নির্দেশাবলী
অডিও আউটপুট (স্পিচ কনফিগারেশন)
পরিষেবার স্তর (অগ্রাধিকার / নমনীয়)
সরঞ্জাম
কোড এক্সিকিউশন টুল
গুগল সার্চ গ্রাউন্ডিং
গুগল ম্যাপস গ্রাউন্ডিং
ইউআরএল কনটেক্সট টুল
ফাইল অনুসন্ধান টুল
কম্পিউটার ব্যবহারের টুল
এমসিপি সার্ভার টুল
রিয়েলটাইম এপিআই
লাইভ এপিআই (ওয়েবসকেটস)
লাইভ মিউজিক এপিআই
ক্ষণস্থায়ী টোকেন (লাইভ এপিআই)
প্ল্যাটফর্ম এপিআই
মডেল এপিআই
ফাইল পরিষেবা রুট
ফাইল অনুসন্ধান রুট সংরক্ষণ করে
এজেন্ট এপিআই
ওয়েবহুকস এপিআই
প্রসঙ্গ ক্যাশিং
  • - সমর্থিত

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

জেমিনি এপিআই এসডিকে-গুলো ডিফল্টভাবে v1beta ভার্সনে থাকে, কিন্তু আপনি নিচের কোড স্যাম্পলে দেখানো অনুযায়ী এপিআই ভার্সন সেট করে সুস্পষ্টভাবে ভার্সন নির্দিষ্ট করে দিতে পারেন:

পাইথন

from google import genai

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

interaction = client.interactions.create(
    model='gemini-3.8-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.8-flash",
    input: "Explain how AI works",
  });
  console.log(interaction.output_text);
}

await main();

জাভা

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(""));

যান

package main

import (
    "context"
    "fmt"
    "log"

    "google.golang.org/genai"
    "google.golang.org/genai/interactions/models/interactions"
    "google.golang.org/genai/interactions/models/operations"
)

func main() {
    ctx := context.Background()
    client, err := genai.NewClient(ctx, &genai.ClientConfig{
        HTTPOptions: genai.HTTPOptions{
            APIVersion: "v1",
        },
    })
    if err != nil {
        log.Fatal(err)
    }

    res, err := client.Interactions.Create(ctx, operations.CreateInteractionRequest{
        Body: operations.NewCreateInteractionRequestBody(interactions.CreateModelInteraction{
            Model: interactions.Model("gemini-3.6-flash"),
            Input: interactions.NewInteractionsInput("Explain how AI works"),
        }),
    })
    if err != nil {
        log.Fatal(err)
    }
    if res.Interaction.OutputText != nil {
        fmt.Println(*res.Interaction.OutputText)
    }
}

বিশ্রাম

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