نقطه پایانی مدلها راهی را برای شما فراهم میکند تا به صورت برنامهنویسی، مدلهای موجود را فهرست کنید و فرادادههای توسعهیافته مانند قابلیتهای پشتیبانیشده و اندازه پنجره زمینه را بازیابی کنید. برای اطلاعات بیشتر به راهنمای مدلها مراجعه کنید.
اطلاعاتی در مورد یک Model خاص مانند شماره نسخه، محدودیتهای توکن، پارامترها و سایر فرادادهها را دریافت میکند. برای اطلاعات دقیق مدل، به راهنمای مدلهای Gemini مراجعه کنید.
https: / /generativelanguage.googleapis.com /v1beta /{name=models /*}string nameالزامی. نام منبع مدل.
این نام باید با نام مدلی که توسط متد models.list برگردانده میشود، مطابقت داشته باشد.
قالب: models/{model} به شکل models/{model} است.
بدنه درخواست باید خالی باشد.
در صورت موفقیت، بدنه پاسخ شامل نمونهای از Model است.
Model موجود از طریق رابط برنامهنویسی نرمافزار Gemini را فهرست میکند.
https: / /generativelanguage.googleapis.com /v1beta /modelsinteger pageSize حداکثر تعداد Models که باید برگردانده شوند (در هر صفحه).
اگر مقدار مشخص نشده باشد، در هر صفحه ۵۰ مدل برگردانده میشود. این متد حداکثر ۱۰۰۰ مدل در هر صفحه برمیگرداند، حتی اگر اندازه صفحه بزرگتری را ارسال کنید.
string pageToken یک توکن صفحه، که از فراخوانی قبلی models.list دریافت شده است.
pageToken برگردانده شده توسط یک درخواست را به عنوان آرگومان برای درخواست بعدی جهت بازیابی صفحه بعدی ارائه دهید.
هنگام صفحهبندی، تمام پارامترهای دیگر ارائه شده به models.list باید با فراخوانی که توکن صفحه را ارائه داده است، مطابقت داشته باشند.
بدنه درخواست باید خالی باشد.
پاسخ از ListModel حاوی فهرستی صفحهبندیشده از مدلها.
در صورت موفقیت، بدنه پاسخ شامل دادههایی با ساختار زیر است:
models[]object ( Model )مدلهای بازگردانده شده
string nextPageToken یک توکن، که میتواند به عنوان pageToken برای بازیابی صفحه بعدی ارسال شود.
اگر این فیلد حذف شود، صفحات بیشتری وجود نخواهد داشت.
| نمایش JSON |
|---|
{
"models": [
{
object ( |
اطلاعاتی در مورد مدل زبان زایشی.
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 } |
درخواست پیشبینی را انجام میدهد.
https: / /generativelanguage.googleapis.com /v1beta /{model=models /*}:predictstring model الزامی. نام مدل برای پیشبینی. قالب: name=models/{model} . به شکل models/{model} است.
بدنه درخواست شامل دادههایی با ساختار زیر است:
instances[]value ( Value format)الزامی. نمونههایی که ورودی فراخوانی پیشبینی هستند.
parametersvalue ( Value format)اختیاری. پارامترهایی که فراخوانی پیشبینی را کنترل میکنند.
پیام پاسخ برای [PredictService.Predict].
در صورت موفقیت، بدنه پاسخ شامل دادههایی با ساختار زیر است:
predictions[]value ( Value format)خروجیهای فراخوانی پیشبینی.
| نمایش JSON |
|---|
{ "predictions": [ value ] } |
همانند models.predict است اما یک LRO برمیگرداند.
https: / /generativelanguage.googleapis.com /v1beta /{model=models /*}:predictLongRunningstring model الزامی. نام مدل برای پیشبینی. قالب: name=models/{model} .
بدنه درخواست شامل دادههایی با ساختار زیر است:
instances[]value ( Value format)الزامی. نمونههایی که ورودی فراخوانی پیشبینی هستند.
parametersvalue ( Value format)اختیاری. پارامترهایی که فراخوانی پیشبینی را کنترل میکنند.
string webhookConfig.uris[]اختیاری. در صورت تنظیم، این URLهای وبهوک به جای وبهوکهای ثبتشده، برای رویدادهای وبهوک استفاده خواهند شد.
در صورت موفقیت، بدنه پاسخ شامل نمونهای از Operation است.