Gemini الأصلي

قائمة النماذج

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

GET
/v1beta/models

يُرجع قائمة بالنماذج المتاحة بتنسيق Google Gemini API.

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

pageSizeintegerquery

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

pageTokenstringquery

رمز متابعة غير شفاف تعيده الصفحة السابقة. أرسله كما هو للحصول على الصفحة التالية.

المصادقة

لا يلزم التوثيق لنقاط قراءة كتالوج النماذج العامة.

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

الاستجابة

modelsarray

مصفوفة من كائنات النماذج.

nextPageTokenstring

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

الأخطاء

  • إعادة 400 INVALID_ARGUMENT عند إرسال pageToken غير صالح.
  • إعادة 500 INTERNAL عند فشل غير متوقع في عرض القائمة.

الطلب

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

الاستجابة

Response
{
  "models": [
    {
      "name": "models/gemini-2.5-pro",
      "version": "gemini-2.5-pro",
      "displayName": "gemini-2.5-pro",
      "description": "gemini-2.5-pro model available via TokenLab",
      "inputTokenLimit": 1048576,
      "outputTokenLimit": 65536,
      "supportedGenerationMethods": [
        "generateContent",
        "countTokens"
      ],
      "baseModelId": "gemini-2.5-pro"
    },
    {
      "name": "models/gemini-3.5-flash",
      "version": "gemini-3.5-flash",
      "displayName": "gemini-3.5-flash",
      "description": "gemini-3.5-flash model available via TokenLab",
      "inputTokenLimit": 1048576,
      "outputTokenLimit": 65536,
      "supportedGenerationMethods": [
        "generateContent",
        "countTokens"
      ],
      "baseModelId": "gemini-3.5-flash"
    }
  ]
}

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

pageSize?integer
النطاق1 <= value <= 1000
pageToken?string

الاستجابة

application/json

application/json

application/json