Models

توفر نقطة نهاية النماذج طريقة لسرد النماذج المتاحة آليًا واسترداد البيانات الوصفية الموسّعة مثل الوظائف المتوافقة وحجم نافذة السياق. اطّلِع على مزيد من المعلومات في دليل النماذج.

الطريقة: model.get

يتم الحصول على معلومات عن Model محدّد، مثل رقم الإصدار وحدود الرموز المميّزة والمَعلمات والبيانات الوصفية الأخرى. يُرجى مراجعة دليل نماذج Gemini للحصول على معلومات مفصّلة حول النماذج.

نقطة نهاية

الحصول على https://generativelanguage.googleapis.com/v1beta/{name=models/*}

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

name string

مطلوب. اسم المورد للنموذج.

ويجب أن يتطابق هذا الاسم مع اسم النموذج الذي تعرضه الطريقة models.list.

التنسيق: models/{model} يأخذ الشكل models/{model}.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

مثال على الطلب

Python

model_info = genai.get_model("models/gemini-1.5-flash-latest")
print(model_info)

صَدفة

curl https://generativelanguage.googleapis.com/v1beta/models/gemini-1.5-flash?key=$GOOGLE_API_KEY

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Model.

الطريقة: model.list

يسرد Model المتاحة من خلال Gemini API.

نقطة نهاية

الحصول على https://generativelanguage.googleapis.com/v1beta/models

معامِلات طلب البحث

pageSize integer

الحد الأقصى لعدد Models التي يمكن عرضها (لكل صفحة).

وفي حال عدم تحديده، سيتم عرض 50 نموذجًا لكل صفحة. تعرض هذه الطريقة 1000 نموذج كحد أقصى لكل صفحة، حتى إذا قمت بتجاوز حجم صفحة أكبر.

pageToken string

رمز مميّز للصفحة، تم تلقّيه من استدعاء سابق لتطبيق "models.list".

يمكنك تقديم pageToken الذي يعرضه طلب واحد كوسيطة للطلب التالي لاسترداد الصفحة التالية.

عند التقسيم على صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى models.list مع الاستدعاء الذي قدّم الرمز المميّز للصفحة.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

مثال على الطلب

Python

print("List of models that support generateContent:\n")
for m in genai.list_models():
    if "generateContent" in m.supported_generation_methods:
        print(m.name)

print("List of models that support embedContent:\n")
for m in genai.list_models():
    if "embedContent" in m.supported_generation_methods:
        print(m.name)

صَدفة

curl https://generativelanguage.googleapis.com/v1beta/models?key=$GOOGLE_API_KEY

نص الاستجابة

استجابة من ListModel تحتوي على قائمة النماذج المقسّمة على صفحات.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

الحقول
models[] object (Model)

الطُرز التي تم إرجاعها.

nextPageToken string

رمز مميّز يمكن إرساله على شكل pageToken لاسترداد الصفحة التالية.

إذا تم حذف هذا الحقل، يعني هذا عدم توفّر المزيد من الصفحات.

تمثيل JSON
{
  "models": [
    {
      object (Model)
    }
  ],
  "nextPageToken": string
}

مورد REST: الطُرز

المرجع: النموذج

معلومات عن النموذج اللغوي التوليدي

الحقول
name string

مطلوب. اسم المورد Model. راجِع خيارات النماذج للاطّلاع على جميع القيم المسموح بها.

التنسيق: models/{model} مع اصطلاح تسمية {model} لـ:

  • "{baseModelId}-{version}"

أمثلة:

  • models/gemini-1.5-flash-001
baseModelId string

مطلوب. اسم النموذج الأساسي، يُرجى إرساله إلى طلب الإنشاء.

أمثلة:

  • gemini-1.5-flash
version string

مطلوب. رقم إصدار النموذج.

تمثّل هذه السمة رقم الإصدار الرئيسي (1.0 أو 1.5).

displayName string

تمثّل هذه السمة اسم النموذج الذي يمكن لشخص عادي قراءته. مثلاً: "Gemini 1.5 Flash".

يمكن أن يصل طول الاسم إلى 128 حرفًا، ويمكن أن يتكون من أي أحرف UTF-8.

description string

تمثل هذه السمة وصفًا موجزًا للنموذج.

inputTokenLimit integer

الحد الأقصى لعدد الرموز المميّزة للإدخال المسموح بها لهذا النموذج.

outputTokenLimit integer

الحد الأقصى لعدد الرموز المميّزة الخاصة بالإخراج المتاحة لهذا النموذج

supportedGenerationMethods[] string

طرق الإنشاء المتوافقة مع النموذج

يتم تحديد أسماء طرق واجهة برمجة التطبيقات المقابلة لها كسلاسل حالة Pascal، مثل generateMessage وgenerateContent.

temperature number

تتحكّم هذه السياسة في التوزيع العشوائي للمخرج.

يمكن أن تتجاوز القيم [0.0,maxTemperature]، بشكل شامل. وستؤدي القيمة الأعلى إلى الحصول على ردود أكثر تنوعًا، في حين تؤدي القيمة الأقرب من 0.0 عادةً إلى الحصول على ردود أقل إثارة للدهشة من النموذج. تحدد هذه القيمة القيمة التلقائية التي سيتم استخدامها بواسطة الخلفية أثناء إجراء طلب إلى النموذج.

maxTemperature number

الحد الأقصى لدرجة الحرارة التي يمكن أن يستخدمها هذا النموذج.

topP number

بالنسبة إلى أخذ عيّنات النواة:

ويأخذ أخذ العينات من النواة بعين الاعتبار أصغر مجموعة من الرموز المميّزة التي يكون مجموع احتمالية حدوثها topP على الأقل. تحدد هذه القيمة القيمة التلقائية التي سيتم استخدامها بواسطة الخلفية أثناء إجراء طلب إلى النموذج.

topK integer

لأخذ العيّنات في المستوى الأعلى.

وفي أخذ العيّنات الأعلى درجة في الاعتبار، يتم جمع topK من الرموز المميّزة الأكثر ترجيحًا. تحدد هذه القيمة القيمة التلقائية التي سيتم استخدامها بواسطة الخلفية أثناء إجراء طلب إلى النموذج. إذا كانت فارغة، هذا يعني أنّ النموذج لا يستخدم أخذ العيّنات من المستوى الأعلى، وأنّ السمة topK غير مسموح بها كمَعلمة إنشاء.

تمثيل JSON
{
  "name": string,
  "baseModelId": string,
  "version": string,
  "displayName": string,
  "description": string,
  "inputTokenLimit": integer,
  "outputTokenLimit": integer,
  "supportedGenerationMethods": [
    string
  ],
  "temperature": number,
  "maxTemperature": number,
  "topP": number,
  "topK": integer
}