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

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

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

• – נתמך
• – לא תהיה תמיכה באפשרות הזו אף פעם

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

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

from google import genai

client = genai.Client(api_key="YOUR_API_KEY",
                      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({
  apiKey: "YOUR_API_KEY",
  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?key=YOUR_API_KEY" \
-H 'Content-Type: application/json' \
-X POST \
-d '{
  "contents": [{
    "parts":[{"text": "Explain how AI works."}]
    }]
   }'