跳转到主要内容
返回以 Google Gemini API 格式表示的可用模型列表。

​
查询参数

​
pageSize
integer
要返回的模型最大数量。默认值：1000，最大值：1000。
​
pageToken
string
上一页返回的不透明续页令牌。将它原样传回即可获取下一页。

​
身份验证

可选。支持与其他 Gemini 端点相同的身份验证方法：
  • ?key=YOUR_API_KEY 查询参数
  • x-goog-api-key: YOUR_API_KEY 请求头
  • Authorization: Bearer YOUR_API_KEY 请求头

​
响应

​
models
array
模型对象数组。
​
nextPageToken
string
当仍有更多模型时返回。将该值作为 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"

import google.generativeai as genai

genai.configure(
    api_key="sk-your-api-key",
    transport="rest",
    client_options={"api_endpoint": "api.tokenlab.sh"}
)

for model in genai.list_models():
    print(model.name)

const response = await fetch(
  "https://api.tokenlab.sh/v1beta/models?pageSize=5",
  { headers: { "x-goog-api-key": "sk-your-api-key" } }
);
const { models } = await response.json();
models.forEach(m => console.log(m.name));

{
  "models": [
    {
      "name": "models/gemini-2.5-pro",
      "version": "1.0",
      "displayName": "gemini-2.5-pro",
      "description": "gemini-2.5-pro model available via TokenLab",
      "inputTokenLimit": 1048576,
      "outputTokenLimit": 65536,
      "supportedGenerationMethods": ["generateContent", "countTokens"],
      "temperature": 1.0,
      "topP": 0.95,
      "topK": 40,
      "maxTemperature": 2.0
    },
    {
      "name": "models/gemini-3.5-flash",
      "version": "1.0",
      "displayName": "gemini-3.5-flash",
      "description": "gemini-3.5-flash model available via TokenLab",
      "inputTokenLimit": 1048576,
      "outputTokenLimit": 65536,
      "supportedGenerationMethods": ["generateContent", "countTokens"],
      "temperature": 1.0,
      "topP": 0.95,
      "topK": 40,
      "maxTemperature": 2.0
    }
  ]
}