Method: models.list

מציג רשימה של מודלים הזמינים דרך ה-API.

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

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

פרמטרים
pageSize

integer

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

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

string

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

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

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

גוף הבקשה

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

גוף התשובה

התשובה של ListModel מכילה רשימת מודלים מעומדת.

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

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

object (Model)

המודלים שהוחזרו.
nextPageToken

string

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

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

היקפי הרשאות

כדי להשתמש בתכונה הזו יש צורך באחד מההיקפים הבאים של OAuth:

  • https://www.googleapis.com/auth/generative-language
  • https://www.googleapis.com/auth/generative-language.tuning
  • https://www.googleapis.com/auth/generative-language.tuning.readonly
  • https://www.googleapis.com/auth/generative-language.retriever
  • https://www.googleapis.com/auth/generative-language.retriever.readonly

למידע נוסף, קראו את הסקירה הכללית על אימות.