Models

Modellerin uç noktası, kullanılabilir modelleri programatik olarak listelemeniz ve desteklenen işlevler ile bağlam penceresi boyutlandırması gibi genişletilmiş meta verileri almanız için bir yol sağlar. Modeller kılavuzunda daha fazla bilgi bulabilirsiniz.

Yöntem: model.get

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

Uç nokta

indir 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

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: model.list

Gemini API üzerinden kullanılabilen Model'ları listeler.

Uç nokta

indir 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 iletseniz bile sayfa başına en fazla 1.000 model döndürür.

pageToken string

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

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

Sayfalara ayırma işlemi sırasında 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

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, modellerin sayfalara ayrılmış bir listesini içeren yanıt.

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

ziyaret edin.
Alanlar
models[] object (Model)

Döndürülen Modeller.

nextPageToken string

Sonraki sayfayı almak için pageToken olarak gönderilebilecek 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.

ziyaret edin.
Alanlar
name string

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

Biçim: {model} adlandırma kuralına göre models/{model}:

  • "{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ü temsil eder (1.0 veya 1.5)

displayName string

Modelin kullanıcılar tarafından okunabilen adı. Ör. "Gemini 1.5 Flash".

Ad en fazla 128 karakter uzunluğunda olabilir ve tüm UTF-8 karakterlerini içerebilir.

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.

Karşılık gelen API yöntemi adları, generateMessage ve generateContent gibi Pascal büyük/küçük harf dizeleri olarak tanımlanır.

temperature number

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

Değerler [0.0,maxTemperature] değerinden yüksek olabilir (bu değerler dahil). Daha yüksek bir değer, daha çeşitli yanıtlar üretirken, 0.0’e daha yakın bir değer genellikle modelin daha az şaşırtıcı yanıtlar vermesini sağlar. Bu değer, modele çağrı yapılırken arka uç tarafından kullanılacak varsayılanı belirtir.

maxTemperature number

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

topP number

Nükleus örneklemesi için.

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

topK integer

Top-k örneklemesi için.

Top-k örneklemesi, en olası topK jeton grubunu dikkate alır. Bu değer, modele çağrı yapılırken arka uç tarafından kullanılacak varsayılanı belirtir. Boşsa modelin birinci taraf örneklemeyi kullanmadığını ve topK öğesine oluşturma parametresi olarak izin verilmediğini 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
}