نسخه های API توضیح داده شده است

این سند یک مرور کلی سطح بالا از تفاوت‌های بین نسخه‌های v1 و v1beta از رابط برنامه‌نویسی Gemini ارائه می‌دهد.

• v1 : نسخه پایدار API. ویژگی‌های موجود در نسخه پایدار در طول عمر نسخه اصلی به طور کامل پشتیبانی می‌شوند. در صورت وجود هرگونه تغییر اساسی، یک نسخه اصلی جدید از API ایجاد می‌شود و نسخه موجود پس از مدت زمان معقولی منسوخ می‌شود. تغییرات اساسی را می‌توان بدون تغییر نسخه اصلی به API اضافه کرد. API تعاملات و ویژگی‌های اصلی آن عموماً در v1 موجود هستند.
• نسخه v1beta : این نسخه شامل ویژگی‌ها و قابلیت‌های اولیه‌ای است که به طور فعال در حال توسعه هستند. اگرچه ویژگی‌های v1beta ممکن است در حین اصلاح بر اساس بازخوردها، دستخوش تغییراتی شوند، اما به شما امکان می‌دهد قابلیت‌های جدید را قبل از ارتقاء به نسخه پایدار، امتحان کنید.

قابلیت‌ها و پشتیبانی از ویژگی‌ها

جدول زیر جزئیات مربوط به قابلیت‌ها در v1 (GA) و v1beta (Beta) را نشان می‌دهد. قابلیت‌ها و ابزارهای Core API هم برای Interactions API و هم generateContent اعمال می‌شوند، مگر اینکه خلاف آن ذکر شده باشد:

• - پشتیبانی شده

پیکربندی نسخه API در SDK

کیت‌های توسعه نرم‌افزار Gemini API به طور پیش‌فرض روی v1beta تنظیم شده‌اند، اما می‌توانید با تنظیم نسخه API، همانطور که در نمونه کد زیر نشان داده شده است، نسخه‌ها را به صراحت مشخص کنید:

کپی کد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",
  }'