Gemini 原生

列出模型

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

GET
/v1beta/models

以 Google Gemini API 格式返回接受 Gemini 请求的模型。每个模型的 supportedGenerationMethods 列出可对它调用的操作。

查询参数

pageSizeintegerquery

要返回的模型最大数量。默认值:50,最大值:1000。

pageTokenstringquery

上一页返回的分页令牌。原样传入即可获取下一页。

身份验证

公共模型目录读取端点不需要身份验证。

?key= 或 x-goog-api-key 这类 Gemini 风格的认证提示不会改变此处的响应。

响应

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