توفر نقطة نهاية النماذج طريقة لسرد النماذج المتاحة آليًا واسترداد البيانات الوصفية الموسّعة مثل الوظائف المتوافقة وحجم نافذة السياق. اطّلِع على مزيد من المعلومات في دليل النماذج.
الطريقة: model.get
يتم الحصول على معلومات عن Model
محدّد، مثل رقم الإصدار وحدود الرموز المميّزة والمَعلمات والبيانات الوصفية الأخرى. يُرجى مراجعة دليل نماذج Gemini للحصول على معلومات مفصّلة حول النماذج.
نقطة نهاية
الحصول على
https://generativelanguage.googleapis.com/v1beta/{name=models/*}
مَعلمات المسار
name
string
مطلوب. اسم المورد للنموذج.
ويجب أن يتطابق هذا الاسم مع اسم النموذج الذي تعرضه الطريقة models.list
.
التنسيق: models/{model}
يأخذ الشكل models/{model}
.
نص الطلب
يجب أن يكون نص الطلب فارغًا.
مثال على الطلب
Python
صَدفة
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال 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
صَدفة
نص الاستجابة
استجابة من ListModel
تحتوي على قائمة النماذج المقسّمة على صفحات.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
models[]
object (Model
)
الطُرز التي تم إرجاعها.
nextPageToken
string
رمز مميّز يمكن إرساله على شكل pageToken
لاسترداد الصفحة التالية.
إذا تم حذف هذا الحقل، يعني هذا عدم توفّر المزيد من الصفحات.
تمثيل JSON |
---|
{
"models": [
{
object ( |
مورد 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 } |