Method: models.list

يسرد النماذج المتاحة من خلال واجهة برمجة التطبيقات.

طلب 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

لمزيد من المعلومات، راجع نظرة عامة على المصادقة.