Models

روش: models.get

اطلاعاتی در مورد یک مدل خاص دریافت می کند.

نقطه پایانی

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)

پوسته

curl https://generativelanguage.googleapis.com/v1beta/models/gemini-pro?key=$GOOGLE_API_KEY

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از Model است.

روش: models.list

مدل های موجود از طریق 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)

پوسته

curl https://generativelanguage.googleapis.com/v1beta/models?key=$GOOGLE_API_KEY

بدن پاسخگو

پاسخ از ListModel حاوی لیست صفحه بندی شده مدل ها.

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

زمینه های
شی models[] object ( Model )

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

string nextPageToken

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

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

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

منبع 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 به عنوان پارامتر تولید مجاز نیست.