Models

Modeller uç noktası, mevcut modelleri programatik olarak listelemenize ve desteklenen işlevler ile bağlam penceresi boyutu gibi genişletilmiş meta verileri almanıza olanak tanır. Daha fazla bilgi için Modeller kılavuzunu okuyun.

Yöntem: models.get

Belirli bir Model hakkında sürüm numarası, jeton sınırları, parametreler ve diğer meta veriler gibi bilgileri alır. Modeller hakkında ayrıntılı bilgi için Gemini modelleri kılavuzuna bakın.

Uç nokta

alın https://generativelanguage.googleapis.com/v1beta/{name=models/*}

Yol parametreleri

name string

Zorunlu. Modelin kaynak adı.

Bu ad, models.list yöntemi tarafından döndürülen bir model adıyla eşleşmelidir.

Biçim: models/{model} models/{model} biçimindedir.

İstek metni

İstek metni boş olmalıdır.

Örnek istek

Python

from google import genai

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

Go

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-3.8-flash", nil)
if err != nil {
	log.Fatal(err)
}

fmt.Println(modelInfo)

kabuk

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

Yanıt metni

Başarılıysa yanıt metni, Model öğesinin bir örneğini içerir.

Yöntem: models.list

Gemini API aracılığıyla kullanılabilen Models listesini döndürür.

Uç nokta

alın https://generativelanguage.googleapis.com/v1beta/models

Sorgu parametreleri

pageSize integer

Döndürülecek maksimum Models sayısı (sayfa başına).

Belirtilmezse sayfa başına 50 model döndürülür. Bu yöntem, daha büyük bir pageSize değeri iletseniz bile sayfa başına en fazla 1.000 model döndürür.

pageToken string

Önceki bir models.list çağrısından alınan sayfa jetonu.

Bir istek tarafından döndürülen pageToken değerini, sonraki sayfayı almak için bir sonraki isteğe bağımsız değişken olarak sağlayın.

Sayfalandırma yapılırken models.list yöntemine sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.

İstek metni

İstek metni boş olmalıdır.

Örnek istek

Python

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)

Go

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
		}
	}
}

kabuk

curl https://generativelanguage.googleapis.com/v1beta/models?key=$GEMINI_API_KEYpan>.sh

Yanıt metni

ListModel tarafından gönderilen ve sayfalandırılmış bir model listesi içeren yanıt.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

Alanlar
models[] object (Model)

Döndürülen modeller.

nextPageToken string

Sonraki sayfayı almak için pageToken olarak gönderilebilen bir jeton.

Bu alan atlanırsa başka sayfa yoktur.

JSON gösterimi 
{
  "models": [
    {
      object (Model)
    }
  ],
  "nextPageToken": string
}

REST Kaynağı: models

Kaynak: Model

Üretken dil modeliyle ilgili bilgiler.

Alanlar
name string

Zorunlu. Model kaynağının adı. İzin verilen tüm değerler için Model varyantları bölümüne bakın.

Biçim: models/{model}, {model} adlandırma kuralı:

  • "{baseModelId}-{version}"

Örnekler:

  • models/gemini-1.5-flash-001
baseModelId string

Zorunlu. Temel modelin adı. Bu adı oluşturma isteğine iletin.

Örnekler:

  • gemini-1.5-flash
version string

Zorunlu. Modelin sürüm numarası.

Bu, ana sürümü (1.0 veya 1.5) temsil eder.

displayName string

Modelin kullanıcı tarafından okunabilen adı. Örneğin, "Gemini 1.5 Flash".

Ad en fazla 128 karakter uzunluğunda olabilir ve herhangi bir UTF-8 karakterinden oluşabilir.

description string

Modelin kısa bir açıklaması.

inputTokenLimit integer

Bu model için izin verilen maksimum giriş jetonu sayısı.

outputTokenLimit integer

Bu model için kullanılabilen maksimum çıkış jetonu sayısı.

supportedGenerationMethods[] string

Modelin desteklenen oluşturma yöntemleri.

İlgili API yöntemi adları, generateMessage ve generateContent gibi PascalCase dizeleri olarak tanımlanır.

thinking boolean

Modelin düşünmeyi destekleyip desteklemediği.

temperature number

Çıktının rastgeleliğini kontrol eder.

Değerler [0.0,maxTemperature] (dahil) üzerinde olabilir. Daha yüksek bir değer, daha çeşitli yanıtlar üretir. 0.0 değerine daha yakın bir değer ise genellikle modelden daha az şaşırtıcı yanıtlar alınmasını sağlar. Bu değer, modele çağrı yapılırken arka uç tarafından kullanılacak varsayılan değeri belirtir.

maxTemperature number

Bu modelin kullanabileceği maksimum sıcaklık.

topP number

Çekirdek örnekleme için.

Çekirdek örnekleme, olasılık toplamı en az topP olan en küçük jeton kümesini dikkate alır. Bu değer, modele çağrı yapılırken arka uç tarafından kullanılacak varsayılan değeri belirtir.

topK integer

Top-k örneklemesi için.

Top-k örneklemesi, en olası topK jeton kümesini dikkate alır. Bu değer, modele çağrı yapılırken arka uç tarafından kullanılacak varsayılan değeri belirtir. Boşsa modelin top-k örnekleme kullanmadığını ve topK parametresinin oluşturma parametresi olarak kullanılmasına izin verilmediğini gösterir.

JSON gösterimi 
{
  "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
}

Yöntem: models.predict

Tahmin isteği gönderir.

Uç nokta

yayın https://generativelanguage.googleapis.com/v1beta/{model=models/*}:predict

Yol parametreleri

model string

Zorunlu. Tahmin için kullanılacak modelin adı. Biçim: name=models/{model}. models/{model} biçimindedir.

İstek metni

İstek içeriği aşağıdaki yapıyla birlikte verileri içerir:

Alanlar
instances[] value (Value format)

Zorunlu. Tahmin çağrısının girişi olan örnekler.

parameters value (Value format)

İsteğe bağlıdır. Tahmin çağrısını yöneten parametreler.

labels map (key: string, value: string)

İsteğe bağlıdır. İstek için kullanıcı tanımlı meta veriler içeren etiketler.

İsteğe bağlıdır. Etiketler, standart birleştirilmiş Cloud etiketi koşullarına uymalıdır: - Etiket anahtarları bir harfle başlamalıdır. - Etiket anahtarları ve değerleri 63 karakterden (Unicode kod noktaları) uzun olamaz ve yalnızca küçük harf, sayısal karakter, alt çizgi ve kısa çizgi içerebilir. - Uluslararası karakterlere izin verilir.

Kullanım: - Toplayıcılardan alınan güvenlik tanımlayıcıları: safety_identifier anahtarını kullanın (ör. {"safety_identifier": "user_session_123"})

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Yanıt metni

[PredictionService.Predict] için yanıt mesajı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

Alanlar
predictions[] value (Value format)

Tahmin çağrısının çıkışları.

JSON gösterimi 
{
  "predictions": [
    value
  ]
}

Yöntem: models.predictLongRunning

models.predict ile aynıdır ancak bir LRO döndürür.

Uç nokta

yayın https://generativelanguage.googleapis.com/v1beta/{model=models/*}:predictLongRunning

Yol parametreleri

model string

Zorunlu. Tahmin için kullanılacak modelin adı. Biçim: name=models/{model}.

İstek metni

İstek içeriği aşağıdaki yapıyla birlikte verileri içerir:

Alanlar
instances[] value (Value format)

Zorunlu. Tahmin çağrısının girişi olan örnekler.

parameters value (Value format)

İsteğe bağlıdır. Tahmin çağrısını yöneten parametreler.

webhookConfig.uris[] string

İsteğe bağlıdır. Ayarlanırsa bu webhook URI'leri, kayıtlı webhook'lar yerine webhook etkinlikleri için kullanılır.

labels map (key: string, value: string)

İsteğe bağlıdır. İstek için kullanıcı tanımlı meta veriler içeren etiketler.

İsteğe bağlıdır. Etiketler, standart birleştirilmiş Cloud etiketi koşullarına uymalıdır: - Etiket anahtarları bir harfle başlamalıdır. - Etiket anahtarları ve değerleri 63 karakterden (Unicode kod noktaları) uzun olamaz ve yalnızca küçük harf, sayısal karakter, alt çizgi ve kısa çizgi içerebilir. - Uluslararası karakterlere izin verilir.

Kullanım: - Toplayıcılardan alınan güvenlik tanımlayıcıları: safety_identifier anahtarını kullanın (ör. {"safety_identifier": "user_session_123"})

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Yanıt metni

Başarılıysa yanıt metni, Operation öğesinin bir örneğini içerir.