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
gethttps: / /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
kabuk
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
gethttps: / /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
kabuk
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:
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 ( |
REST Kaynağı: modeller
Kaynak: Model
Üretken dil modeli hakkında bilgi.
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 } |