TokenLab

Gemini 原生

列出模型

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

GET
/v1beta/models

以 Google Gemini API 格式傳回可用模型列表。

查詢參數

pageSizeintegerquery

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

pageTokenstringquery

上一頁回傳的不透明續頁權杖。將它原樣帶回即可取得下一頁。

身份驗證

選填。支援與其他 Gemini 端點相同的身份驗證方法:

  • ?key=YOUR_API_KEY 查詢參數
  • x-goog-api-key: YOUR_API_KEY 標頭
  • Authorization: Bearer YOUR_API_KEY 標頭

回應

modelsarray

模型物件陣列。

nextPageTokenstring

當仍有更多模型時回傳。將此值作為 pageToken 傳回即可繼續分頁。

錯誤

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

請求

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

回應

Response
{
  "models": [
    {
      "name": "models/gemini-2.5-pro",
      "version": "gemini-2.5-pro",
      "displayName": "gemini-2.5-pro",
      "description": "gemini-2.5-pro model available via TokenLab",
      "inputTokenLimit": 1048576,
      "outputTokenLimit": 65536,
      "supportedGenerationMethods": [
        "generateContent",
        "countTokens"
      ],
      "baseModelId": "gemini-2.5-pro"
    },
    {
      "name": "models/gemini-3.5-flash",
      "version": "gemini-3.5-flash",
      "displayName": "gemini-3.5-flash",
      "description": "gemini-3.5-flash model available via TokenLab",
      "inputTokenLimit": 1048576,
      "outputTokenLimit": 65536,
      "supportedGenerationMethods": [
        "generateContent",
        "countTokens"
      ],
      "baseModelId": "gemini-3.5-flash"
    }
  ]
}

查詢參數

pageSize?integer
範圍1 <= value <= 1000
pageToken?string

回應

application/json

application/json

application/json