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

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

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

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

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

Python

ב-Python SDK, ‏ google.generativeai, נעשה שימוש ב-v1beta ולא קיימת שיטה למעבר לגרסה אחרת של ה-API.

ספריית הלקוח ברמה נמוכה של Python, google.ai.generativelanguage, חושפת גרסאות אחרות כמודולים נפרדים: google.ai.generativelanguage_v1 ו-google.ai.generativelanguage_v1beta. ערך ברירת המחדל הוא v1beta.

import google.ai.generativelanguage_v1 as glm

client = glm.GenerativeServiceClient(
    client_options=dict(api_key=YOUR_API_KEY))

response = client.generate_content({
  "model": "models/gemini-1.5-flash",
  "contents": [ {"parts": [ {"text": "Explain how AI works"}]}]
})

print(type(response).to_dict(response))

Node.js

const { GoogleGenerativeAI } = require("@google/generative-ai");

const genAI = new GoogleGenerativeAI("YOUR_API_KEY");
const model = genAI.getGenerativeModel({ model: 'gemini-1.5-flash' }, { apiVersion: 'v1' });

const prompt = "Explain how AI works";

const result = await model.generateContent(prompt);
console.log(result.response.text());

REST

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": "Write a story about a magic backpack."}]
    }]
   }'