Gemini native

List Models

Mencantumkan model yang tersedia menggunakan format Google Gemini API

GET
/v1beta/models

Mengembalikan model yang menerima permintaan Gemini, dalam format Google Gemini API. supportedGenerationMethods dari setiap model mencantumkan tindakan yang dapat Anda panggil pada model tersebut.

Query Parameters

pageSizeintegerquery

Jumlah maksimum model yang akan dikembalikan. Default: 50, maksimum: 1000.

pageTokenstringquery

Token kelanjutan yang dikembalikan oleh halaman sebelumnya. Teruskan kembali tanpa perubahan untuk mengambil bagian berikutnya.

Authentication

Autentikasi tidak diperlukan untuk endpoint baca katalog model publik.

Petunjuk autentikasi gaya Gemini seperti ?key= atau x-goog-api-key tidak mengubah kontrak respons di sini.

Respons

modelsarray

Array objek model. Lihat Dapatkan Model untuk detail bidangnya.

nextPageTokenstring

Dikembalikan saat lebih banyak model tersedia. Teruskan nilai ini sebagai pageToken untuk melanjutkan penomoran halaman (pagination).

Errors

  • pageToken yang tidak valid mengembalikan 400 INVALID_ARGUMENT.
  • Kegagalan daftar yang tidak terduga mengembalikan 500 INTERNAL.

Permintaan

curl "https://api.tokenlab.sh/v1beta/models?pageSize=2" \
  -H "x-goog-api-key: sk-your-api-key"

Respons

Response
{
  "models": [
    {
      "name": "models/gemini-2.5-flash",
      "baseModelId": "gemini-2.5-flash",
      "version": "gemini-2.5-flash",
      "displayName": "Gemini 2.5 Flash",
      "description": "Fast Gemini workhorse for multimodal apps where latency and price matter",
      "inputTokenLimit": 1048576,
      "outputTokenLimit": 65536,
      "supportedGenerationMethods": [
        "generateContent",
        "streamGenerateContent",
        "countTokens"
      ]
    },
    {
      "name": "models/gemini-2.5-flash-lite",
      "baseModelId": "gemini-2.5-flash-lite",
      "version": "gemini-2.5-flash-lite",
      "displayName": "Gemini 2.5 Flash-Lite",
      "description": "Lean Gemini 2.5 lane for cheap multimodal traffic and quick agents",
      "inputTokenLimit": 1048576,
      "outputTokenLimit": 65536,
      "supportedGenerationMethods": [
        "generateContent",
        "streamGenerateContent",
        "countTokens"
      ]
    }
  ],
  "nextPageToken": "b2Zmc2V0OjI"
}

Parameter query

pageSize?integer

Jumlah maksimum model yang akan dikembalikan. Default: 50.

Rentang1 <= value <= 1000
bawaan50
pageToken?string

Token kelanjutan dari halaman sebelumnya. Token yang tidak valid akan mengembalikan 400.

Respons

application/json

application/json

application/json