Models

modeller uç noktası, mevcut modelleri programatik olarak listelemenizin ve desteklenen işlevler ve bağlam penceresi boyutu gibi genişletilmiş meta verileri almanın bir yolunu sağlar. Daha fazla bilgi için Modeller kılavuzunu inceleyin.

Yöntem: models.get

Belirli bir Model hakkında bilgi alır (ör. sürüm numarası, jeton sınırları, parametreler ve diğer meta veriler). Modellerle ilgili ayrıntılı bilgi için Gemini model 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

import google.generativeai as genai

model_info = genai.get_model("models/gemini-1.5-flash-latest")
print(model_info)

kabuk

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

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 Model öğelerini listeler.

Uç nokta

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

Sorgu parametreleri

pageSize integer

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

Belirtilmemesi durumunda sayfa başına 50 model döndürülür. Bu yöntem, daha büyük bir pageSize 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, bir 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 parametresine 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

import google.generativeai as genai

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)

kabuk

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

Yanıt gövdesi

ListModel tarafından gönderilen, sayfalara ayrı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ğı: modeller

Kaynak: Model

Üretken dil modeli hakkında bilgi.

Alanlar
name string

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

Biçim: models/{model}, şu adlandırma kuralını kullanır:{model}

  • "{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ı.

Ana sürümü (1.0 veya 1.5) temsil eder.

displayName string

Modelin, kullanıcılar tarafından okunabilir adı. Ör. "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ı, Pascal büyük/küçük harf kullanımıyla yazılmış dizeler (ör. generateMessage ve generateContent) olarak tanımlanır.

temperature number

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

Değerler [0.0,maxTemperature]'ten büyük olabilir ([0.0,maxTemperature] dahil). Daha yüksek bir değer, daha çeşitli yanıtlar üretirken 0.0 değerine yakın bir değer, modelin genellikle daha az şaşırtıcı yanıtlar vermesine 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

En iyi k örnekleme için.

En yüksek k örnekleme, 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 en iyi k örneklemeyi kullanmadığını ve topK parametresinin oluşturma parametresi olarak kullanılamayacağını gösterir.

JSON gösterimi
{
  "name": string,
  "baseModelId": string,
  "version": string,
  "displayName": string,
  "description": string,
  "inputTokenLimit": integer,
  "outputTokenLimit": integer,
  "supportedGenerationMethods": [
    string
  ],
  "temperature": number,
  "maxTemperature": number,
  "topP": number,
  "topK": integer
}