Models

الطريقة: model.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)

صَدفة

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

نص الاستجابة

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

الطريقة: model.list

يسرد النماذج المتوفّرة من خلال واجهة برمجة التطبيقات.

نقطة نهاية

الحصول على 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: الطُرز

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

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

تمثيل 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
}
الحقول
name string

مطلوب. اسم المورد Model.

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

  • "{baseModelId}-{version}"

أمثلة:

  • models/chat-bison-001
baseModelId string

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

أمثلة:

  • chat-bison
version string

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

يمثل هذا الإصدار الرئيسي

displayName string

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

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

description string

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

inputTokenLimit integer

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

outputTokenLimit integer

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

supportedGenerationMethods[] string

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

يتم تعريف أسماء الطرق على أنّها سلاسل حالة Pascal، مثل generateMessage التي تتوافق مع طُرق واجهة برمجة التطبيقات.

temperature number

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

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

maxTemperature number

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

topP number

لأخذ عينات من النواة

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

topK integer

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

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