Models

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

الطريقة: model.get

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

نقطة نهاية

get 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)
models.py

صَدفة

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

نص الاستجابة

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

الطريقة: model.list

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

نقطة نهاية

get https://generativelanguage.googleapis.com/v1beta/models

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

pageSize integer

الحد الأقصى لعدد Models المطلوب عرضها (لكل صفحة)

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

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)
models.py

صَدفة

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

نص الاستجابة

استجابة من 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

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

تأخذ تقنية أخذ عيّنات من أهمّ k عنصرًا في الاعتبار مجموعة من 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
}