הסבר על גרסאות 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."}]
    }]
   }'