روش: models.get
اطلاعاتی در مورد یک مدل خاص دریافت می کند.
نقطه پایانی
https://generativelanguage.googleapis.com/v1beta/{name=models/*}
را دریافت کنیدپارامترهای مسیر
string
name
ضروری. نام منبع مدل
این نام باید با نام مدلی که با روش models.list
برگردانده شده است مطابقت داشته باشد.
قالب: models/{model}
شکل models/{model}
را میگیرد.
درخواست بدن
بدنه درخواست باید خالی باشد.
درخواست نمونه
پایتون
پوسته
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از Model
است.
روش: models.list
مدل های موجود از طریق API را فهرست می کند.
نقطه پایانی
https://generativelanguage.googleapis.com/v1beta/models
را دریافت کنیدپارامترهای پرس و جو
pageSize
integer
حداکثر تعداد Models
برای بازگشت (در هر صفحه).
ممکن است این سرویس مدل های کمتری را برگرداند. اگر نامشخص باشد، حداکثر 50 مدل در هر صفحه بازگردانده می شود. این روش حداکثر 1000 مدل را در هر صفحه برمی گرداند، حتی اگر یک pageSize بزرگتر را ارسال کنید.
string
pageToken
یک نشانه صفحه، دریافت شده از تماس قبلی models.list
.
pageToken
که توسط یک درخواست بازگردانده شده است به عنوان آرگومان برای درخواست بعدی برای بازیابی صفحه بعدی ارائه دهید.
هنگام صفحه بندی، تمام پارامترهای دیگر ارائه شده به models.list
باید با فراخوانی که توکن صفحه را ارائه می کند مطابقت داشته باشد.
درخواست بدن
بدنه درخواست باید خالی باشد.
درخواست نمونه
پایتون
پوسته
بدن پاسخگو
پاسخ از ListModel
حاوی لیست صفحه بندی شده مدل ها.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
models[]
object ( Model
)
مدل های برگشتی
string
nextPageToken
یک نشانه، که می تواند به عنوان pageToken
برای بازیابی صفحه بعدی ارسال شود.
اگر این قسمت حذف شود، صفحه دیگری وجود ندارد.
نمایندگی JSON |
---|
{
"models": [
{
object ( |
منبع 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 } |
string
name
ضروری. نام منبع Model
قالب: models/{model}
با قرارداد نامگذاری {model}
از:
- "{baseModelId}-{version}"
مثال ها:
-
models/chat-bison-001
string
baseModelId
ضروری. نام مدل پایه، این را به درخواست نسل منتقل کنید.
مثال ها:
-
chat-bison
string
version
ضروری. شماره نسخه مدل
این نشان دهنده نسخه اصلی است
string
displayName
نام قابل خواندن برای انسان مدل. به عنوان مثال "چت بیسون".
نام می تواند حداکثر 128 کاراکتر باشد و می تواند از هر کاراکتر UTF-8 تشکیل شود.
string
description
توضیح مختصری در مورد مدل
inputTokenLimit
integer
حداکثر تعداد کدهای ورودی مجاز برای این مدل.
outputTokenLimit
integer
حداکثر تعداد توکن های خروجی موجود برای این مدل.
string
supportedGenerationMethods[]
روش های تولید پشتیبانی شده مدل
نام متدها به صورت رشته های موردی Pascal تعریف می شوند، مانند generateMessage
که با متدهای API مطابقت دارد.
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
به عنوان پارامتر تولید مجاز نیست.