Models

Modeller uç noktası, kullanılabilir modelleri programatik olarak listelemenize ve desteklenen işlevler ile bağlam penceresi boyutlandırma gibi genişletilmiş meta verileri almanıza olanak tanır. Daha fazla bilgiyi Modeller kılavuzunda bulabilirsiniz.

Yöntem: models.get

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

Uç nokta

get 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 içeriği

İstek metni boş olmalıdır.

Örnek istek

Python

from google import genai

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

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

fmt.Println(modelInfo)
models.go

kabuk

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

Yanıt gövdesi

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

Yöntem: models.list

Gemini API üzerinden kullanılabilen Models listelenir.

Uç nokta

get 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 iletmiş olsanız 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 sonraki isteğe bağımsız değişken olarak iletin.

Sayfalara ayırma işlemi yapılırken models.list öğesine sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.

İstek içeriği

İ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)
models.py

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
		}
	}
}
models.go

kabuk

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

Yanıt gövdesi

ListModel'dan gelen ve Modellerin sayfalandırılmış listesini 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ğı: modeller

Kaynak: Model

Üretken dil modeli hakkında bilgiler.

Alanlar
name string

Zorunlu. Model öğesinin kaynak adı. İzin verilen tüm değerler için Model varyantları başlıklı makaleyi inceleyin.

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

  • "{baseModelId}-{version}"

Örnekler:

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

Zorunlu. Temel modelin adı. Bunu 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ılar tarafından okunabilir 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 Pascal büyük/küçük harf dizeleri olarak tanımlanır.

thinking boolean

Modelin düşünmeyi destekleyip desteklemediği.

temperature number

Çıkışın rastgeleliğini kontrol eder.

Değerler [0.0,maxTemperature] arasında (bu değerler dahil) 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ına neden olur. 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 grubunu 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 örnekleme için.

Top-k örnekleme, topK en olası 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 üst K örneklemesi kullanmadığını ve topK karakterinin 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 gerçekleştirir.

Uç nokta

post https://generativelanguage.googleapis.com/v1beta/{model=models/*}:predict

Yol parametreleri

model string

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

İstek içeriği

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

Alanlar
instances[] value (Value format)

Zorunlu. Tahmin çağrısına giriş olarak kullanılan örnekler.

parameters value (Value format)

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

Yanıt gövdesi

[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 LRO döndürür.

Uç nokta

post https://generativelanguage.googleapis.com/v1beta/{model=models/*}:predictLongRunning

Yol parametreleri

model string

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

İstek içeriği

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

Alanlar
instances[] value (Value format)

Zorunlu. Tahmin çağrısına giriş olarak kullanılan örnekler.

parameters value (Value format)

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

Yanıt gövdesi

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