Gemini 原生

列出模型

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

GET
/v1beta/models

返回可通过 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