TokenLab

Gemini 原生

列出模型

使用 Google Gemini API 格式列出可用模型

GET
/v1beta/models

以 Google Gemini API 格式返回接受 Gemini 請求的模型。每個模型的 supportedGenerationMethods 列出了您可以對其呼叫的操作。

查詢參數

pageSizeintegerquery

要返回的最大模型數量。預設值:50,最大值:1000。

pageTokenstringquery

由前一頁返回的接續 token。將其原樣傳回以獲取下一頁資料。

身份驗證

公開模型目錄的讀取端點不需要身份驗證。

Gemini 風格的驗證提示(例如 ?key= 或 x-goog-api-key)不會更改此處的響應契約。

響應

modelsarray

模型物件陣列。請參閱 取得模型 以了解欄位資訊。

nextPageTokenstring

當有更多模型可用時返回。將此值作為 pageToken 傳遞以繼續分頁。

錯誤

  • 無效的 pageToken 會返回 400 INVALID_ARGUMENT。
  • 未預期的列表失敗會返回 500 INTERNAL。

請求

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

回應

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"
}

查詢參數

pageSize?integer

傳回模型的最大數量。預設值:50。

範圍1 <= value <= 1000
預設值50
pageToken?string

來自前一頁的接續 token。無效的 token 將回傳 400。

回應

application/json

application/json

application/json