Endpoint models menyediakan cara bagi Anda untuk mencantumkan model yang tersedia secara terprogram, dan mengambil metadata yang diperluas seperti fungsi yang didukung dan ukuran jendela konteks. Baca selengkapnya di panduan Model.
Metode: models.get
Mendapatkan informasi tentang Model tertentu seperti nomor versinya, batas token, parameter, dan metadata lainnya. Lihat panduan model Gemini untuk mengetahui informasi model yang mendetail.
Endpoint
gethttps: / /generativelanguage.googleapis.com /v1beta /{name=models /*}
Parameter jalur
name
string
Wajib. Nama resource model.
Nama ini harus sama dengan nama model yang ditampilkan oleh metode models.list.
Format: models/{model} Formatnya adalah models/{model}.
Isi permintaan
Isi permintaan harus kosong.
Contoh permintaan
Python
Go
Shell
Isi respons
Jika berhasil, isi respons memuat instance Model.
Metode: models.list
Mencantumkan Model yang tersedia melalui Gemini API.
Endpoint
gethttps: / /generativelanguage.googleapis.com /v1beta /models
Parameter kueri
pageSize
integer
Jumlah maksimum Models yang akan ditampilkan (per halaman).
Jika tidak ditentukan, 50 model akan ditampilkan per halaman. Metode ini menampilkan maksimal 1.000 model per halaman, meskipun Anda meneruskan pageSize yang lebih besar.
pageToken
string
Token halaman, yang diterima dari panggilan models.list sebelumnya.
Berikan pageToken yang ditampilkan oleh satu permintaan sebagai argumen ke permintaan berikutnya untuk mengambil halaman berikutnya.
Saat melakukan penomoran halaman, semua parameter lain yang disediakan untuk models.list harus sesuai dengan panggilan yang memberikan token halaman.
Isi permintaan
Isi permintaan harus kosong.
Contoh permintaan
Python
Go
Shell
Isi respons
Respons dari ListModel yang berisi daftar Model yang diberi nomor halaman.
Jika berhasil, isi respons memuat data dengan struktur berikut:
models[]
object (Model)
Model yang ditampilkan.
nextPageToken
string
Token yang dapat dikirim sebagai pageToken untuk mengambil halaman berikutnya.
Jika kolom ini dihilangkan, tidak akan ada halaman lagi.
| Representasi JSON |
|---|
{
"models": [
{
object ( |
Resource REST: models
Resource: Model
Informasi tentang Model Bahasa Generatif.
name
string
Wajib. Nama resource Model. Lihat Varian model untuk mengetahui semua nilai yang diizinkan.
Format: models/{model} dengan konvensi penamaan {model}:
- "{baseModelId}-{version}"
Contoh:
models/gemini-1.5-flash-001
baseModelId
string
Wajib. Nama model dasar, teruskan ini ke permintaan pembuatan.
Contoh:
gemini-1.5-flash
version
string
Wajib. Nomor versi model.
Ini mewakili versi utama (1.0 atau 1.5)
displayName
string
Nama model yang dapat dibaca manusia. Misalnya, "Gemini 1.5 Flash".
Nama dapat berisi hingga 128 karakter dan dapat terdiri dari karakter UTF-8 apa pun.
description
string
Deskripsi singkat model.
inputTokenLimit
integer
Jumlah maksimum token input yang diizinkan untuk model ini.
outputTokenLimit
integer
Jumlah maksimum token output yang tersedia untuk model ini.
supportedGenerationMethods[]
string
Metode pembuatan yang didukung model.
Nama metode API yang sesuai ditentukan sebagai string Pascal case, seperti generateMessage dan generateContent.
thinking
boolean
Apakah model mendukung penalaran.
temperature
number
Mengontrol keacakan output.
Nilai dapat berkisar di atas [0.0,maxTemperature], inklusif. Nilai yang lebih tinggi akan menghasilkan respons yang lebih bervariasi, sedangkan nilai yang lebih mendekati 0.0 biasanya akan menghasilkan respons yang lebih dapat diprediksi dari model. Nilai ini menentukan default yang akan digunakan oleh backend saat melakukan panggilan ke model.
maxTemperature
number
Suhu maksimum yang dapat digunakan model ini.
topP
number
Untuk Sampling inti.
Sampling inti mempertimbangkan kumpulan token terkecil yang jumlah probabilitasnya minimal topP. Nilai ini menentukan default yang akan digunakan oleh backend saat melakukan panggilan ke model.
topK
integer
Untuk sampling Top-k.
Sampling top-k mempertimbangkan kumpulan topK token yang paling mungkin. Nilai ini menentukan default yang akan digunakan oleh backend saat melakukan panggilan ke model. Jika kosong, berarti model tidak menggunakan pengambilan sampel top-k, dan topK tidak diizinkan sebagai parameter pembuatan.
| Representasi JSON |
|---|
{ "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 } |
Metode: models.predict
Melakukan permintaan prediksi.
Endpoint
posthttps: / /generativelanguage.googleapis.com /v1beta /{model=models /*}:predict
Parameter jalur
model
string
Wajib. Nama model untuk prediksi. Format: name=models/{model}. Formatnya adalah models/{model}.
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
instances[]
value (Value format)
Wajib. Instance yang merupakan input ke panggilan prediksi.
parameters
value (Value format)
Opsional. Parameter yang mengatur panggilan prediksi.
labels
map (key: string, value: string)
Opsional. Label dengan metadata yang ditentukan pengguna untuk permintaan.
Opsional. Label harus mengikuti persyaratan label Cloud terpadu standar: - Kunci label harus diawali dengan huruf. - Kunci dan nilai label tidak boleh melampaui 63 karakter (codepoint Unicode) dan hanya boleh berisi huruf kecil, karakter numerik, garis bawah, dan tanda hubung. - Karakter internasional diperbolehkan.
Penggunaan: - ID keamanan dari agregator: Gunakan kunci safety_identifier (misalnya, {"safety_identifier": "user_session_123"})
Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
Isi respons
Pesan respons untuk [PredictionService.Predict].
Jika berhasil, isi respons memuat data dengan struktur berikut:
predictions[]
value (Value format)
Output panggilan prediksi.
| Representasi JSON |
|---|
{ "predictions": [ value ] } |
Metode: models.predictLongRunning
Sama seperti models.predict, tetapi menampilkan LRO.
Endpoint
posthttps: / /generativelanguage.googleapis.com /v1beta /{model=models /*}:predictLongRunning
Parameter jalur
model
string
Wajib. Nama model untuk prediksi. Format: name=models/{model}.
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
instances[]
value (Value format)
Wajib. Instance yang merupakan input ke panggilan prediksi.
parameters
value (Value format)
Opsional. Parameter yang mengatur panggilan prediksi.
webhookConfig.uris[]
string
Opsional. Jika ditetapkan, URI webhook ini akan digunakan untuk peristiwa webhook, bukan webhook yang terdaftar.
labels
map (key: string, value: string)
Opsional. Label dengan metadata yang ditentukan pengguna untuk permintaan.
Opsional. Label harus mengikuti persyaratan label Cloud terpadu standar: - Kunci label harus diawali dengan huruf. - Kunci dan nilai label tidak boleh melampaui 63 karakter (codepoint Unicode) dan hanya boleh berisi huruf kecil, karakter numerik, garis bawah, dan tanda hubung. - Karakter internasional diperbolehkan.
Penggunaan: - ID keamanan dari agregator: Gunakan kunci safety_identifier (misalnya, {"safety_identifier": "user_session_123"})
Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
Isi respons
Jika berhasil, isi respons memuat instance Operation.