نقطه پایانی مدلها راهی را برای شما فراهم میکند تا به صورت برنامهنویسی، مدلهای موجود را فهرست کنید و فرادادههای توسعهیافته مانند قابلیتهای پشتیبانیشده و اندازه پنجره زمینه را بازیابی کنید. برای اطلاعات بیشتر به راهنمای مدلها مراجعه کنید.
روش: models.get
 اطلاعاتی در مورد یک Model خاص مانند شماره نسخه، محدودیتهای توکن، پارامترها و سایر فرادادهها را دریافت میکند. برای اطلاعات دقیق مدل، به راهنمای مدلهای Gemini مراجعه کنید.
نقطه پایانی
دریافتhttps: / /generativelanguage.googleapis.com /v1beta /{name=models /*}پارامترهای مسیر
string nameالزامی. نام منبع مدل.
 این نام باید با نام مدلی که توسط متد models.list برگردانده میشود، مطابقت داشته باشد.
 قالب: models/{model} به شکل models/{model} است. 
درخواست بدنه
بدنه درخواست باید خالی باشد.
درخواست نمونه
پایتون
برو
پوسته
بدنه پاسخ
 در صورت موفقیت، بدنه پاسخ شامل نمونهای از Model است. 
روش: models.list
 Model موجود از طریق رابط برنامهنویسی نرمافزار Gemini را فهرست میکند.
نقطه پایانی
دریافتhttps: / /generativelanguage.googleapis.com /v1beta /modelsپارامترهای پرس و جو
integer pageSize حداکثر تعداد Models که باید برگردانده شوند (در هر صفحه).
اگر مقدار مشخص نشده باشد، در هر صفحه ۵۰ مدل برگردانده میشود. این متد حداکثر ۱۰۰۰ مدل در هر صفحه برمیگرداند، حتی اگر اندازه صفحه بزرگتری را ارسال کنید.
string pageToken یک توکن صفحه، که از فراخوانی قبلی models.list دریافت شده است.
 pageToken برگردانده شده توسط یک درخواست را به عنوان آرگومان برای درخواست بعدی جهت بازیابی صفحه بعدی ارائه دهید.
 هنگام صفحهبندی، تمام پارامترهای دیگر ارائه شده به models.list باید با فراخوانی که توکن صفحه را ارائه داده است، مطابقت داشته باشند. 
درخواست بدنه
بدنه درخواست باید خالی باشد.
درخواست نمونه
پایتون
برو
پوسته
بدنه پاسخ
 پاسخ از ListModel حاوی فهرستی صفحهبندیشده از مدلها.
در صورت موفقیت، بدنه پاسخ شامل دادههایی با ساختار زیر است:
models[]object ( Model )مدلهای بازگردانده شده
string nextPageToken یک توکن، که میتواند به عنوان pageToken برای بازیابی صفحه بعدی ارسال شود.
اگر این فیلد حذف شود، صفحات بیشتری وجود نخواهد داشت.
| نمایش JSON | 
|---|
| {
  "models": [
    {
      object ( | 
منبع 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نام مدل که برای انسان قابل خواندن باشد. مثلاً "Gemini 1.5 Flash".
این نام میتواند تا ۱۲۸ کاراکتر داشته باشد و میتواند شامل هر کاراکتر UTF-8 باشد.
string descriptionشرح مختصری از مدل.
integer inputTokenLimitحداکثر تعداد توکنهای ورودی مجاز برای این مدل.
integer outputTokenLimitحداکثر تعداد توکنهای خروجی موجود برای این مدل.
string supportedGenerationMethods[]روشهای تولید پشتیبانیشده توسط مدل.
 نام متدهای API مربوطه به صورت رشتههای حالت پاسکال تعریف میشوند، مانند generateMessage و generateContent . 
thinkingbooleanاینکه آیا مدل از تفکر پشتیبانی میکند یا خیر.
number temperatureتصادفی بودن خروجی را کنترل میکند.
 مقادیر میتوانند شامل [0.0,maxTemperature] باشند. مقدار بالاتر، پاسخهایی با تنوع بیشتر تولید میکند، در حالی که مقداری نزدیکتر به 0.0 معمولاً منجر به پاسخهای کمتر غافلگیرکننده از مدل میشود. این مقدار، مقدار پیشفرضی را که توسط backend هنگام فراخوانی مدل استفاده میشود، مشخص میکند. 
number maxTemperatureحداکثر دمایی که این مدل میتواند استفاده کند.
number topPبرای نمونهبرداری از هسته
 نمونهگیری هستهای، کوچکترین مجموعه از توکنها را که مجموع احتمال آنها حداقل topP باشد، در نظر میگیرد. این مقدار، مقدار پیشفرضی را که باید توسط backend هنگام فراخوانی مدل استفاده شود، مشخص میکند. 
integer topKبرای نمونهبرداری 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 ], "thinking": boolean, "temperature": number, "maxTemperature": number, "topP": number, "topK": integer } | 
روش: models.predict
درخواست پیشبینی را انجام میدهد.
نقطه پایانی
پستhttps: / /generativelanguage.googleapis.com /v1beta /{model=models /*}:predictپارامترهای مسیر
string model الزامی. نام مدل برای پیشبینی. قالب: name=models/{model} . به شکل models/{model} است. 
درخواست بدنه
بدنه درخواست شامل دادههایی با ساختار زیر است:
instances[]value ( Value format)الزامی. نمونههایی که ورودی فراخوانی پیشبینی هستند.
parametersvalue ( Value format)اختیاری. پارامترهایی که فراخوانی پیشبینی را کنترل میکنند.
بدنه پاسخ
پیام پاسخ برای [PredictService.Predict].
در صورت موفقیت، بدنه پاسخ شامل دادههایی با ساختار زیر است:
predictions[]value ( Value format)خروجیهای فراخوانی پیشبینی.
| نمایش JSON | 
|---|
| { "predictions": [ value ] } | 
روش: models.predictLongRunning
همانند models.predict است اما یک LRO برمیگرداند.
نقطه پایانی
پستhttps: / /generativelanguage.googleapis.com /v1beta /{model=models /*}:predictLongRunningپارامترهای مسیر
string model الزامی. نام مدل برای پیشبینی. قالب: name=models/{model} . 
درخواست بدنه
بدنه درخواست شامل دادههایی با ساختار زیر است:
instances[]value ( Value format)الزامی. نمونههایی که ورودی فراخوانی پیشبینی هستند.
parametersvalue ( Value format)اختیاری. پارامترهایی که فراخوانی پیشبینی را کنترل میکنند.
بدنه پاسخ
 در صورت موفقیت، بدنه پاسخ شامل نمونهای از Operation است.