Models

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

שיטה: models.get

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

נקודת קצה

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

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

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

name string

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

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

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

גוף הבקשה

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

בקשה לדוגמה

Python

import google.generativeai as genai

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

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

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

pageSize integer

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

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

pageToken string

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

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

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

גוף הבקשה

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

בקשה לדוגמה

Python

import google.generativeai as genai

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
}