נקודת הקצה של המודלים מאפשרת להציג באופן פרוגרמטי את המודלים הזמינים, ולאחזר מטא-נתונים מורחבים, כמו פונקציונליות נתמכת וגודל חלון ההקשר. מידע נוסף זמין במדריך למודלים.
שיטה: models.get
מקבל מידע על Model
ספציפי, כמו מספר הגרסה, מגבלות האסימון, הפרמטרים ומטא-נתונים נוספים שלו. מידע מפורט על המודל זמין במדריך למודלים של Gemini.
נקודת קצה
הורדה
https://generativelanguage.googleapis.com/v1beta/{name=models/*}
פרמטרים של נתיב
name
string
חובה. שם המשאב של המודל.
השם הזה צריך להיות תואם לשם הדגם שהוחזר על ידי השיטה models.list
.
פורמט: models/{model}
הוא מופיע בפורמט models/{model}
.
גוף הבקשה
גוף הבקשה חייב להיות ריק.
דוגמה לבקשה
Python
קונכייה
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול מופע של 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
קונכייה
גוף התשובה
התשובה מ-ListModel
שמכילה רשימה בחלוקה של מודלים.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:
models[]
object (Model
)
הדגמים שהוחזרו.
nextPageToken
string
אסימון, שניתן לשלוח בתור pageToken
כדי לאחזר את הדף הבא.
אם השדה הזה יושמט, אין דפים נוספים.
ייצוג JSON |
---|
{
"models": [
{
object ( |
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 } |