Method: models.list

مدل های موجود از طریق API را فهرست می کند.

درخواست HTTP

GET https://generativelanguage.googleapis.com/v1beta/models

URL از دستور GRPC Transcoding استفاده می کند.

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

مولفه های
pageSize

integer

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

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

pageToken

string

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

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

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

درخواست بدن

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

بدن پاسخگو

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

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

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

object ( Model )

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

nextPageToken

string

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

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

محدوده مجوز

به یکی از حوزه های OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/generative-language
  • https://www.googleapis.com/auth/generative-language.tuning
  • https://www.googleapis.com/auth/generative-language.tuning.readonly
  • https://www.googleapis.com/auth/generative-language.retriever
  • https://www.googleapis.com/auth/generative-language.retriever.readonly

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