Models

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

שיטה: models.get

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

נקודת קצה

הורדה 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.

נקודת קצה

הורדה 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 Resource: מודלים

משאב: מודל

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

שדות
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,maxTemperature], כולל. ערך גבוה יותר יניב תשובות מגוונות יותר. לעומת זאת, ערך קרוב יותר ל-0.0 בדרך כלל יניב תשובות פחות מפתיעות מהמודל. הערך הזה מציין את ברירת המחדל שתשמש את הקצה העורפי בזמן ביצוע הקריאה למודל.

maxTemperature number

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

topP number

עבור דגימת גרעין.

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

topK integer

לדגימת ה-Top-K.

דגימת הדגלים מבוססת על סט של topK האסימונים בעלי הסבירות הגבוהה ביותר. הערך הזה מציין את ברירת המחדל שתשמש את הקצה העורפי בזמן ביצוע הקריאה למודל. אם השדה ריק, המשמעות היא שהמודל לא משתמש בדגימת k-top ו-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
}