Models

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

الطريقة: models.get

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

نقطة نهاية

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

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

name string

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

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

التنسيق: models/{model} يكون على الشكل models/{model}.

نص الطلب

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

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

Python

import google.generativeai as genai

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.

الطريقة: models.list

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

نقطة نهاية

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

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

pageSize integer

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

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

pageToken string

رمز مميّز للصفحة، تم تلقّيه من مكالمة models.list سابقة

قدِّم pageToken الذي تم إرجاعه من خلال طلب واحد كوسيطة للطلب التالي لاسترداد الصفحة التالية.

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

نص الطلب

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

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

Python

import google.generativeai as genai

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: models

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

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

الحقول
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 case، مثل generateMessage وgenerateContent.

temperature number

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

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

maxTemperature number

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

topP number

لتحليل عيّنات النواة

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

topK integer

لتحليل عيّنات "أهمّ k منتج"

تأخذ تقنية أخذ عيّنات من أهمّ k بعين الاعتبار مجموعة من topK الرموز الأكثر احتمالًا. تحدِّد هذه القيمة الإعداد التلقائي الذي ستستخدمه الخلفية أثناء إجراء المكالمة إلى النموذج. إذا كانت فارغة، يشير ذلك إلى أنّ النموذج لا يستخدم تحليل عيّنات "أهمّ k"، ولا يُسمح باستخدام 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
}