Models

نقطه پایانی مدل‌ها راهی را برای شما فراهم می‌کند که بتوانید مدل‌های موجود را به‌صورت برنامه‌نویسی فهرست کنید و ابرداده‌های گسترده‌ای مانند عملکرد پشتیبانی‌شده و اندازه‌بندی پنجره زمینه را بازیابی کنید. در راهنمای مدل ها بیشتر بخوانید.

روش: models.get

اطلاعاتی در مورد یک Model خاص مانند شماره نسخه، محدودیت‌های رمز، پارامترها و سایر ابرداده‌ها دریافت می‌کند. برای اطلاعات دقیق مدل به راهنمای مدل های Gemini مراجعه کنید.

نقطه پایانی

https://generativelanguage.googleapis.com/v1beta/{name=models/*} را دریافت کنید

پارامترهای مسیر

string name

مورد نیاز. نام منبع مدل

این نام باید با نام مدلی که با روش models.list برگردانده شده است مطابقت داشته باشد.

قالب: models/{model} شکل models/{model} را می‌گیرد.

درخواست بدن

بدنه درخواست باید خالی باشد.

درخواست نمونه

پایتون 

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 را دریافت کنید

پارامترهای پرس و جو

pageSize integer

حداکثر تعداد Models برای بازگشت (در هر صفحه).

اگر نامشخص باشد، 50 مدل در هر صفحه بازگردانده می شود. این روش حداکثر 1000 مدل را در هر صفحه برمی گرداند، حتی اگر یک pageSize بزرگتر را ارسال کنید.

string pageToken

یک نشانه صفحه، دریافت شده از تماس قبلی models.list .

pageToken را که توسط یک درخواست بازگردانده شده است به عنوان آرگومان برای درخواست بعدی برای بازیابی صفحه بعدی ارائه دهید.

هنگام صفحه بندی، تمام پارامترهای دیگر ارائه شده به models.list باید با فراخوانی که توکن صفحه را ارائه می کند مطابقت داشته باشد.

درخواست بدن

بدنه درخواست باید خالی باشد.

درخواست نمونه

پایتون 

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 )

مدل های برگشتی

string nextPageToken

یک نشانه، که می تواند به عنوان pageToken برای بازیابی صفحه بعدی ارسال شود.

اگر این قسمت حذف شود، صفحه دیگری وجود ندارد.

نمایندگی JSON 
{
  "models": [
    {
      object (Model)
    }
  ],
  "nextPageToken": string
}

منبع REST: مدل ها

منبع: مدل

اطلاعات در مورد یک مدل زبان مولد.

فیلدها
string name

مورد نیاز. نام منبع Model برای همه مقادیر مجاز به انواع مدل مراجعه کنید.

قالب: models/{model} با قرارداد نامگذاری {model} :

  • "{baseModelId}-{version}"

مثال ها:

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

مورد نیاز. نام مدل پایه، این را به درخواست نسل منتقل کنید.

مثال ها:

  • gemini-1.5-flash
string version

مورد نیاز. شماره نسخه مدل

این نشان دهنده نسخه اصلی ( 1.0 یا 1.5 ) است.

string displayName

نام قابل خواندن برای انسان مدل. به عنوان مثال "جمینی 1.5 فلش".

نام می تواند حداکثر 128 کاراکتر باشد و می تواند از هر کاراکتر UTF-8 تشکیل شود.

string description

توضیح مختصری در مورد مدل

inputTokenLimit integer

حداکثر تعداد کدهای ورودی مجاز برای این مدل.

outputTokenLimit integer

حداکثر تعداد توکن های خروجی موجود برای این مدل.

string supportedGenerationMethods[]

روش های تولید پشتیبانی شده مدل

نام‌های متد API مربوطه به‌عنوان رشته‌های موردی پاسکال، مانند generateMessage و generateContent تعریف می‌شوند.

number temperature

تصادفی بودن خروجی را کنترل می کند.

مقادیر می توانند بیش از [0.0,maxTemperature] شامل شوند. مقدار بالاتر پاسخ‌هایی را تولید می‌کند که متنوع‌تر هستند، در حالی که مقدار نزدیک‌تر به 0.0 معمولاً منجر به پاسخ‌های شگفت‌انگیز کمتری از مدل می‌شود. این مقدار پیش‌فرض را مشخص می‌کند که در هنگام برقراری تماس با مدل توسط backend استفاده شود.

maxTemperature number دما

حداکثر دمایی که این مدل می تواند استفاده کند.

number topP

برای نمونه برداری هسته

نمونه برداری هسته کوچکترین مجموعه ای از نشانه ها را در نظر می گیرد که مجموع احتمال آنها حداقل topP باشد. این مقدار پیش‌فرض را مشخص می‌کند که در هنگام برقراری تماس با مدل توسط backend استفاده شود.

topK integer

برای نمونه گیری Top-k.

نمونه گیری Top-k مجموعه ای از محتمل ترین توکن های topK را در نظر می گیرد. این مقدار پیش‌فرض را مشخص می‌کند که در هنگام برقراری تماس با مدل توسط backend استفاده شود. اگر خالی باشد، نشان می دهد که مدل از نمونه برداری top-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
}