Gemini الأصلي

الحصول على النموذج

الحصول على البيانات الوصفية للنموذج باستخدام تنسيق Google Gemini API

GET
/v1beta/models/{model}

يُرجع البيانات الوصفية لنموذج واحد يقبل طلبات Gemini، بتنسيق Google Gemini API.

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

modelstringpathمطلوب

اسم النموذج (مثل gemini-2.5-pro و gemini-3.5-flash). تُقبل الأسماء المستعارة أيضاً.

المصادقة

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

الاستجابة

namestring

اسم مورد النموذج بتنسيق models/{model}.

baseModelIdstring

معرّف النموذج المستخدم في الطلبات. إذا استخدم المسار اسماً مستعاراً، فهذا هو النموذج الذي يشير إليه الاسم المستعار.

displayNamestring

اسم النموذج بصيغة مقروءة للبشر.

inputTokenLimitinteger

الحد الأقصى لـ input tokens (نافذة السياق). يُحذف عندما يكون غير معروف.

outputTokenLimitinteger

الحد الأقصى لـ output tokens. يُحذف عندما يكون غير معروف.

supportedGenerationMethodsarray

الإجراءات التي يمكنك استدعاؤها على هذا النموذج هي generateContent و streamGenerateContent و countTokens. بينما يعرض نموذج embedding الذي يقبل طلبات Gemini كلاً من embedContent و batchEmbedContents بدلاً من ذلك.

versionstring

إصدار النموذج. القيمة الافتراضية هي معرّف النموذج.

descriptionstring

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

temperaturenumber

قيمة temperature الافتراضية عندما يوفرها النموذج.

topPnumber

قيمة top-p الافتراضية عند توفرها.

topKinteger

قيمة top-k الافتراضية عند توفرها.

maxTemperaturenumber

أقصى قيمة مدعومة لـ temperature عند توفرها.

الأخطاء

  • طلبات GET غير الصالحة التي تتضمن دون قصد :generateContent أو :streamGenerateContent تُرجع 405 METHOD_NOT_ALLOWED.
  • النماذج غير المعروفة، والنماذج التي لا تقبل طلبات Gemini، تُرجع 404 NOT_FOUND.

الطلب

curl "https://api.tokenlab.sh/v1beta/models/gemini-2.5-pro"

الاستجابة

Response
{
  "name": "models/gemini-2.5-pro",
  "baseModelId": "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",
    "streamGenerateContent",
    "countTokens"
  ]
}

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

model*string

اسم النموذج أو الاسم المستعار (مثلاً، gemini-2.5-pro)

الاستجابة

application/json

application/json

application/json

application/json