Models

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

שיטה: models.get

הפונקציה מקבלת מידע על Model ספציפי, כמו מספר הגרסה שלו, מגבלות האסימונים, הפרמטרים ומטא-נתונים אחרים. מידע מפורט על המודלים זמין במדריך למודלים של Gemini.

נקודת קצה

get https://generativelanguage.googleapis.com/v1beta/{name=models/*}

פרמטרים של נתיב

name string

חובה. שם המשאב של המודל.

השם הזה צריך להיות תואם לשם הדגם שהוחזר על ידי השיטה models.list.

פורמט: models/{model} הפורמט הוא models/{model}.

גוף הבקשה

גוף הבקשה חייב להיות ריק.

דוגמה לבקשה

Python

model_info = genai.get_model("models/gemini-1.5-flash-latest")
print(model_info)
models.py

קונכייה

curl https://generativelanguage.googleapis.com/v1beta/models/gemini-1.5-flash?key=$GOOGLE_API_KEY
models.sh

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול מופע של Model.

השיטה: models.list

רשימה של Model הזמינים דרך Gemini API.

נקודת קצה

get https://generativelanguage.googleapis.com/v1beta/models

פרמטרים של שאילתה

pageSize integer

המספר המקסימלי של Models להחזרה (לכל דף).

אם לא מציינים ערך, יוחזרו 50 דגמים בכל דף. שיטה זו מחזירה לכל היותר 1,000 מודלים לדף, גם אם מעבירים גודל דף גדול יותר.

pageToken string

אסימון דף, שהתקבל מקריאה קודמת ב-models.list.

כדי לאחזר את הדף הבא, מציינים את הערך של pageToken שהוחזר על ידי בקשה אחת כארגומנטים לבקשה הבאה.

כשמחלקים את הדפים, כל הפרמטרים האחרים שסופקו ל-models.list חייבים להתאים לקריאה שסיפקה את אסימון הדף.

גוף הבקשה

גוף הבקשה חייב להיות ריק.

דוגמה לבקשה

Python

print("List of models that support generateContent:\n")
for m in genai.list_models():
    if "generateContent" in m.supported_generation_methods:
        print(m.name)

print("List of models that support embedContent:\n")
for m in genai.list_models():
    if "embedContent" in m.supported_generation_methods:
        print(m.name)
models.py

קונכייה

curl https://generativelanguage.googleapis.com/v1beta/models?key=$GOOGLE_API_KEY
models.sh

גוף התשובה

תגובה מ-ListModel שמכילה רשימה מחולקת לדפים של מודלים.

אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:

שדות
models[] object (Model)

הדגמים שהוחזרו.

nextPageToken string

אסימון שאפשר לשלוח כ-pageToken כדי לאחזר את הדף הבא.

אם השדה הזה לא יצוין, לא יהיו דפים נוספים.

ייצוג ב-JSON 
{
  "models": [
    {
      object (Model)
    }
  ],
  "nextPageToken": string
}

משאב REST: models

משאב: מודל

מידע על מודל שפה גנרטיבי.

שדות
name string

חובה. שם המשאב של Model. כל הערכים המותרים מפורטים במאמר וריאציות של מודלים.

פורמט: models/{model} עם מוסכמה למתן שמות ל-{model} של:

  • "‎{baseModelId}-{version}‎"

דוגמאות:

  • models/gemini-1.5-flash-001
baseModelId string

חובה. שם המודל הבסיסי, מעבירים אותו לבקשת הגנרציה.

דוגמאות:

  • gemini-1.5-flash
version string

חובה. מספר הגרסה של המודל.

הוא מייצג את הגרסה הראשית (1.0 או 1.5)

displayName string

השם של המודל שקריא לבני אדם. לדוגמה "Gemini 1.5 Flash".

השם יכול להכיל עד 128 תווים, והוא יכול להיות מורכב מכל תווים של UTF-8.

description string

תיאור קצר של המודל.

inputTokenLimit integer

המספר המקסימלי של אסימוני קלט שמותר למודל הזה.

outputTokenLimit integer

המספר המקסימלי של אסימוני פלט שזמינים במודל הזה.

supportedGenerationMethods[] string

שיטות היצירה הנתמכות במודל.

השמות התואמים של שיטות ה-API מוגדרים כמחרוזות אותיות רישיות של פסקל, למשל generateMessage ו-generateContent.

temperature number

קובעת את מידת הרנדומיזציה של הפלט.

הערכים יכולים לנוע בין 0 ל-[0.0,maxTemperature], כולל. ערך גבוה יותר יניב תשובות מגוונות יותר, ואילו ערך קרוב יותר ל-0.0 יניב בדרך כלל תשובות פחות מפתיעות מהמודל. הערך הזה מציין את ברירת המחדל שתשמש את הקצה העורפי בזמן ביצוע הקריאה למודל.

maxTemperature number

הטמפרטורה המקסימלית שבה אפשר להשתמש במודל הזה.

topP number

לדגימת Nucleus.

במדגם Nucleus נלקחת בחשבון הקבוצה הקטנה ביותר של אסימונים שסכום הסבירות שלהם הוא לפחות topP. הערך הזה מציין את ברירת המחדל שתשמש את הקצה העורפי בזמן ביצוע הקריאה למודל.

topK integer

לדגימת Top-k.

דגימת מסוג 'Top-K' מביאה בחשבון את קבוצת topK האסימונים בעלי הסבירות הגבוהה ביותר. הערך הזה מציין את ברירת המחדל שבה הקצה העורפי ישתמש בזמן הקריאה למודל. אם השדה ריק, המשמעות היא שהמודל לא משתמש במדגם top-k, ו-topK לא מורשה כפרמטר יצירת מודלים.

ייצוג JSON 
{
  "name": string,
  "baseModelId": string,
  "version": string,
  "displayName": string,
  "description": string,
  "inputTokenLimit": integer,
  "outputTokenLimit": integer,
  "supportedGenerationMethods": [
    string
  ],
  "temperature": number,
  "maxTemperature": number,
  "topP": number,
  "topK": integer
}