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

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

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

• ‫ – נתמך
• ‫ – לא תהיה תמיכה לעולם

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

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

from google import genai

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

response = client.models.generate_content(
    model='gemini-2.0-flash',
    contents="Explain how AI works",
)

print(response.text)

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

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

async function main() {
  const response = await ai.models.generateContent({
    model: "gemini-2.0-flash",
    contents: "Explain how AI works",
  });
  console.log(response.text);
}

await main();

curl "https://generativelanguage.googleapis.com/v1/models/gemini-1.5-flash:generateContent" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H 'Content-Type: application/json' \
-X POST \
-d '{
  "contents": [{
    "parts":[{"text": "Explain how AI works."}]
    }]
   }'