KToken Docs

Appearance

GET /v1beta/models 与 GET /v1beta/models/:model ​

接口用途 ​

Gemini 原生 REST 兼容的模型枚举接口。

请求路径 ​

text
GET /v1beta/models
GET /v1beta/models/:model

认证方式 ​

  • Authorization: Bearer <API_KEY>
  • x-api-key: <API_KEY>
  • x-goog-api-key: <API_KEY>，Gemini SDK / CLI 推荐

路由别名 ​

无根路径别名。

Antigravity 对应专用前缀：

  • GET /antigravity/v1beta/models
  • GET /antigravity/v1beta/models/:model

适用平台 ​

  • 当前分组平台为 Gemini
  • 或 Antigravity 专用前缀下的强制平台模式

上游官方规范 ​

本项目支持说明 ​

  • 会先检查当前分组平台是否为 Gemini
  • 如果是 Antigravity 强制平台，会返回 Antigravity 的 Gemini 兼容模型视图
  • 当上游因为 scope 不足无法列模型时，代码会回退到静态模型列表

参数说明 ​

GET /v1beta/models ​

无业务请求体。

GET /v1beta/models/:model ​

参数类型必填说明
modelstring是模型名，例如 gemini-2.5-pro

响应说明 ​

模型列表 ​

json
{
  "models": [
    {
      "name": "models/gemini-2.5-pro",
      "displayName": "Gemini 2.5 Pro"
    }
  ]
}

单模型 ​

json
{
  "name": "models/gemini-2.5-pro",
  "displayName": "Gemini 2.5 Pro"
}

错误响应 ​

平台不匹配 ​

json
{
  "error": {
    "code": 400,
    "message": "API key group platform is not gemini",
    "status": "INVALID_ARGUMENT"
  }
}

URL 缺少模型名 ​

json
{
  "error": {
    "code": 400,
    "message": "Missing model in URL",
    "status": "INVALID_ARGUMENT"
  }
}

示例请求 ​

bash
curl https://your-domain/api/v1/v1beta/models \
  -H "x-goog-api-key: sk-xxxx"
bash
curl https://your-domain/api/v1/v1beta/models/gemini-2.5-pro \
  -H "x-goog-api-key: sk-xxxx"

注意事项 ​

  • 这是 Gemini SDK / CLI 的首选入口
  • 如果你在 Antigravity 分组下接入 Gemini，优先考虑专用前缀