Gemini الأصلي

سرد النماذج

سرد النماذج المتاحة باستخدام تنسيق Google Gemini API

GET
/v1beta/models

إرجاع النماذج التي تقبل طلبات Gemini، بتنسيق Google Gemini API. يسرد الحقل supportedGenerationMethods لكل نموذج الإجراءات التي يمكنك استدعاؤها عليه.

معاملات الاستعلام (Query Parameters)

pageSizeintegerquery

الحد الأقصى لعدد النماذج المراد إرجاعها. القيمة الافتراضية: 50، والحد الأقصى: 1000.

pageTokenstringquery

رمز التكملة (token) الذي تم إرجاعه من صفحة سابقة. قم بتمريره كما هو لجلب الجزء التالي من النتائج.

المصادقة (Authentication)

المصادقة غير مطلوبة لنقاط نهاية قراءة كتالوج النماذج العامة.

تلميحات المصادقة بنمط Gemini مثل ?key= أو x-goog-api-key لا تغير عقد الاستجابة هنا.

الاستجابة (Response)

modelsarray

مصفوفة من كائنات النماذج. راجع الحصول على نموذج لمعرفة الحقول.

nextPageTokenstring

يتم إرجاعه عند توفر المزيد من النماذج. قم بتمرير هذه القيمة كـ pageToken لمتابعة التصفح.

الأخطاء (Errors)

  • إرجاع pageToken غير صالح يؤدي إلى 400 INVALID_ARGUMENT.
  • فشل السرد غير المتوقع يؤدي إلى 500 INTERNAL.

الطلب

curl "https://api.tokenlab.sh/v1beta/models?pageSize=2" \
  -H "x-goog-api-key: sk-your-api-key"

الاستجابة

Response
{
  "models": [
    {
      "name": "models/gemini-2.5-flash",
      "baseModelId": "gemini-2.5-flash",
      "version": "gemini-2.5-flash",
      "displayName": "Gemini 2.5 Flash",
      "description": "Fast Gemini workhorse for multimodal apps where latency and price matter",
      "inputTokenLimit": 1048576,
      "outputTokenLimit": 65536,
      "supportedGenerationMethods": [
        "generateContent",
        "streamGenerateContent",
        "countTokens"
      ]
    },
    {
      "name": "models/gemini-2.5-flash-lite",
      "baseModelId": "gemini-2.5-flash-lite",
      "version": "gemini-2.5-flash-lite",
      "displayName": "Gemini 2.5 Flash-Lite",
      "description": "Lean Gemini 2.5 lane for cheap multimodal traffic and quick agents",
      "inputTokenLimit": 1048576,
      "outputTokenLimit": 65536,
      "supportedGenerationMethods": [
        "generateContent",
        "streamGenerateContent",
        "countTokens"
      ]
    }
  ],
  "nextPageToken": "b2Zmc2V0OjI"
}

معاملات الاستعلام

pageSize?integer

الحد الأقصى لعدد النماذج المراد إرجاعها. الافتراضي: 50.

النطاق1 <= value <= 1000
الافتراضي50
pageToken?string

رمز الاستمرار (continuation token) من صفحة سابقة. الرمز غير الصالح يعيد 400.

الاستجابة

application/json

application/json

application/json