Models

نقطه پایانی مدل‌ها راهی را برای شما فراهم می‌کند تا به صورت برنامه‌نویسی، مدل‌های موجود را فهرست کنید و فراداده‌های توسعه‌یافته مانند قابلیت‌های پشتیبانی‌شده و اندازه پنجره زمینه را بازیابی کنید. برای اطلاعات بیشتر به راهنمای مدل‌ها مراجعه کنید.

روش: models.get

اطلاعاتی در مورد یک Model خاص مانند شماره نسخه، محدودیت‌های توکن، پارامترها و سایر فراداده‌ها را دریافت می‌کند. برای اطلاعات دقیق مدل، به راهنمای مدل‌های Gemini مراجعه کنید.

نقطه پایانی

دریافت https: / /generativelanguage.googleapis.com /v1beta /{name=models /*}

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

string name

الزامی. نام منبع مدل.

این نام باید با نام مدلی که توسط متد models.list برگردانده می‌شود، مطابقت داشته باشد.

قالب: models/{model} به شکل models/{model} است.

درخواست بدنه

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

درخواست نمونه

پایتون

from google import genai

client = genai.Client()
model_info = client.models.get(model="gemini-2.0-flash")
print(model_info)

برو

ctx := context.Background()
client, err := genai.NewClient(ctx, &genai.ClientConfig{
	APIKey:  os.Getenv("GEMINI_API_KEY"),
	Backend: genai.BackendGeminiAPI,
})
if err != nil {
	log.Fatal(err)
}

modelInfo, err := client.Models.Get(ctx, "gemini-2.0-flash", nil)
if err != nil {
	log.Fatal(err)
}

fmt.Println(modelInfo)

پوسته

curl https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash?key=$GEMINI_API_KEY

بدنه پاسخ

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

روش: models.list

Model موجود از طریق رابط برنامه‌نویسی نرم‌افزار Gemini را فهرست می‌کند.

نقطه پایانی

دریافت https: / /generativelanguage.googleapis.com /v1beta /models

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

integer pageSize

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

اگر مقدار مشخص نشده باشد، در هر صفحه ۵۰ مدل برگردانده می‌شود. این متد حداکثر ۱۰۰۰ مدل در هر صفحه برمی‌گرداند، حتی اگر اندازه صفحه بزرگتری را ارسال کنید.

string pageToken

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

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

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

درخواست بدنه

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

درخواست نمونه

پایتون

from google import genai

client = genai.Client()

print("List of models that support generateContent:\n")
for m in client.models.list():
    for action in m.supported_actions:
        if action == "generateContent":
            print(m.name)

print("List of models that support embedContent:\n")
for m in client.models.list():
    for action in m.supported_actions:
        if action == "embedContent":
            print(m.name)

برو

ctx := context.Background()
client, err := genai.NewClient(ctx, &genai.ClientConfig{
	APIKey:  os.Getenv("GEMINI_API_KEY"),
	Backend: genai.BackendGeminiAPI,
})
if err != nil {
	log.Fatal(err)
}


// Retrieve the list of models.
models, err := client.Models.List(ctx, &genai.ListModelsConfig{})
if err != nil {
	log.Fatal(err)
}

fmt.Println("List of models that support generateContent:")
for _, m := range models.Items {
	for _, action := range m.SupportedActions {
		if action == "generateContent" {
			fmt.Println(m.Name)
			break
		}
	}
}

fmt.Println("\nList of models that support embedContent:")
for _, m := range models.Items {
	for _, action := range m.SupportedActions {
		if action == "embedContent" {
			fmt.Println(m.Name)
			break
		}
	}
}

پوسته

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

بدنه پاسخ

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

در صورت موفقیت، بدنه پاسخ شامل داده‌هایی با ساختار زیر است:

فیلدها
شیء models[] object ( Model )

مدل‌های بازگردانده شده

string nextPageToken

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

اگر این فیلد حذف شود، صفحات بیشتری وجود نخواهد داشت.

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

منبع 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 .

thinking boolean

اینکه آیا مدل از تفکر پشتیبانی می‌کند یا خیر.

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)

الزامی. نمونه‌هایی که ورودی فراخوانی پیش‌بینی هستند.

مقدار parameters value ( 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)

الزامی. نمونه‌هایی که ورودی فراخوانی پیش‌بینی هستند.

مقدار parameters value ( Value format)

اختیاری. پارامترهایی که فراخوانی پیش‌بینی را کنترل می‌کنند.

بدنه پاسخ

در صورت موفقیت، بدنه پاسخ شامل نمونه‌ای از Operation است.