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. Modeller kılavuzunda daha fazla bilgi bulabilirsiniz.

Yöntem: model.get

Belirli bir Model hakkında 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

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

kabuk

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

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

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 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 isteğin döndürdüğü pageToken öğesini sonraki isteğin bağımsız değişkeni 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)
models.py

kabuk

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

Yanıt gövdesi

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

Kaynak: Model

Üretken dil modeli hakkında bilgi.

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: {model} adlandırma kuralına göre models/{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 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.

İ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

Çıkışı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 verirken 0.0 değerine 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 değeri belirtir.

maxTemperature number

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

topP number

Nükleus örneklemesi 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
}