הסבר על גרסאות API

במסמך הזה מפורטת סקירה כללית של ההבדלים בין גרסאות Gemini API‏: v1 ו-v1beta.

  • v1: גרסה יציבה של ה-API. התכונות בגרסה היציבה נתמכות באופן מלא במהלך מחזור החיים של הגרסה הראשית. אם יש שינויים שעלולים לשבור את התאימות לאחור, ניצור גרסה ראשית חדשה של ה-API והגרסה הקיימת תוצא משימוש אחרי תקופה סבירה. יכול להיות שיוכנסו שינויים שלא ישברו את התאימות לאחור לממשק ה-API בלי לשנות את הגרסה הראשית. ‫Interactions API והתכונות העיקריות שלו זמינים בדרך כלל ב-v1.
  • v1beta: הגרסה הזו כוללת תכונות ויכולות מוקדמות שנמצאות בפיתוח פעיל. יכול להיות שנבצע שינויים בתכונות ב-v1beta כדי לשפר אותן על סמך המשוב שנקבל, אבל תוכלו לנסות יכולות חדשות לפני שהן יהפכו ליציבות.

תמיכה ביכולות ובתכונות

בטבלה הבאה מפורטת הזמינות של היכולות ב-v1 (GA) וב-v1beta (בטא). היכולות והכלים העיקריים של API חלים על Interactions API ועל generateContent אלא אם צוין אחרת:

תכונה v1 v1beta
יכולות הליבה של ה-API
Interactions API
בקשה להפעלת פונקציה
פלט מובנה
חשיבה / חשיבה רציונלית
הוראות מערכת
פלט אודיו (הגדרות דיבור)
רמת השירות (עדיפות / Flex)
כלים
כלי להרצת קוד
הארקה בחיפוש Google
הארקה של מפות Google
הכלי לניתוח הקשר של כתובת URL
כלי לחיפוש קבצים
כלי לשימוש במחשב
כלי שרתי MCP
ממשקי API בזמן אמת
Live API (WebSockets)
Live Music API
טוקנים זמניים (Live API)
Platform APIs
Models API
Files Service Route
File Search Stores Route
Agents API
Webhooks API
שמירת נתונים במטמון לפי הקשר
  • – נתמך

הגדרת גרסת API ב-SDK

ערכות ה-SDK של Gemini API מוגדרות כברירת מחדל לגרסה v1beta, אבל אפשר לציין גרסאות באופן מפורש על ידי הגדרת גרסת ה-API כמו בדוגמת הקוד הבאה:

Python

from google import genai

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

interaction = client.interactions.create(
    model='gemini-3.7-flash',
    input="Explain how AI works",
)

print(interaction.output_text)

JavaScript

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({
  httpOptions: { apiVersion: "v1" },
});

async function main() {
  const interaction = await ai.interactions.create({
    model: "gemini-3.7-flash",
    input: "Explain how AI works",
  });
  console.log(interaction.output_text);
}

await main();

Java

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

REST

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