Gemini 原生

获取模型

使用 Google Gemini API 格式获取模型元数据

GET
/v1beta/models/{model}

以 Google Gemini API 格式返回一个接受 Gemini 请求的模型的元数据。

路径参数

modelstringpath必填

模型名称(例如:gemini-2.5-pro,gemini-3.5-flash)。也支持别名。

身份验证

公共模型元数据读取端点不需要身份验证。

响应

namestring

models/{model} 格式的模型资源名称。

baseModelIdstring

请求中使用的模型 ID。如果路径使用了别名,这里是别名对应的模型。

displayNamestring

模型的显示名称。

inputTokenLimitinteger

最大输入 token 数(上下文窗口)。未知时省略。

outputTokenLimitinteger

最大输出 token 数。未知时省略。

supportedGenerationMethodsarray

可对该模型调用的操作:generateContent、streamGenerateContent 和 countTokens。接受 Gemini 请求的 Embedding 模型则列出 embedContent 和 batchEmbedContents。

versionstring

模型版本。默认为模型 ID。

descriptionstring

可用时的人类可读模型描述。

temperaturenumber

模型提供时的默认 temperature。

topPnumber

可用时的默认 top-p 值。

topKinteger

可用时的默认 top-k 值。

maxTemperaturenumber

可用时支持的最大 temperature。

错误

  • 如果 GET 请求错误地带上了 :generateContent 或 :streamGenerateContent,会返回 405 METHOD_NOT_ALLOWED。
  • 未知模型,以及不接受 Gemini 请求的模型,会返回 404 NOT_FOUND。

请求

curl "https://api.tokenlab.sh/v1beta/models/gemini-2.5-pro"

响应

Response
{
  "name": "models/gemini-2.5-pro",
  "baseModelId": "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",
    "streamGenerateContent",
    "countTokens"
  ]
}

路径参数

model*string

模型名称或别名(例如 gemini-2.5-pro)

响应

application/json

application/json

application/json

application/json