Models

שיטה: models.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)

קונכייה

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

גוף התשובה

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

השיטה: models.list

הצגת רשימה של מודלים שזמינים דרך ה-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)

קונכייה

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

גוף התשובה

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

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

שדות
models[] object (Model)

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

nextPageToken string

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

אם השדה הזה יושמט, אין דפים נוספים.

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

REST Resource: מודלים

משאב: מודל

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

ייצוג 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
}
שדות
name string

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

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

  • "{baseModelId}-{version}"

דוגמאות:

  • models/chat-bison-001
baseModelId string

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

דוגמאות:

  • chat-bison
version string

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

הוא מייצג את הגרסה הראשית

displayName string

שם המודל קריא לאנשים. למשל Chat Bison.

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

description string

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

inputTokenLimit integer

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

outputTokenLimit integer

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

supportedGenerationMethods[] string

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

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

temperature number

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

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

maxTemperature number

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

topP number

לצורך דגימת גרעין.

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

topK integer

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

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