Models API

列出和查看所有可用的 Gemini 模型及其详细信息

GET/gemini/v1beta/models

公开接口

Models API 是公开接口，无需认证即可调用。这使得它可以方便地用于获取模型列表、查看模型能力等场景。

列出所有模型

返回平台上所有可用的 Gemini 模型列表。

请求示例

curl https://api.mintcloud.ai/gemini/v1beta/models \
  -H "x-goog-api-key: $MINTCLOUD_API_KEY"

响应格式

{
  "models": [
    {
      "name": "models/gemini-3.1-flash-lite-preview",
      "version": "1.0",
      "displayName": "Gemini 3.1 Flash Lite",
      "description": "轻量级快速响应模型，适合高并发场景",
      "inputTokenLimit": 100000,
      "outputTokenLimit": 8192,
      "supportedGenerationMethods": ["generateContent", "countTokens"],
      "temperature": 0.9,
      "topP": 0.95,
      "topK": 40
    },
    {
      "name": "models/gemini-3.1-pro",
      "version": "1.0",
      "displayName": "Gemini 3.1 Pro",
      "description": "高性能多模态模型，适合复杂任务",
      "inputTokenLimit": 200000,
      "outputTokenLimit": 16384,
      "supportedGenerationMethods": ["generateContent", "countTokens"],
      "temperature": 1.0,
      "topP": 0.95,
      "topK": 40
    }
  ]
}

与 OpenAI 协议的字段差异

Gemini API 响应使用 camelCase 字段命名，与 OpenAI 的snake_case 不同。

OpenAI	Gemini	说明
data	models	数组字段名不同
id	name	Gemini 的 name 带 models/ 前缀
context_length	inputTokenLimit + outputTokenLimit	分开表示输入和输出限制
snake_case	camelCase	字段命名风格不同

Model 对象字段

参数	类型	必填	说明
name	string	否	模型唯一标识符，带 models/ 前缀，如 models/gemini-3.1-flash-lite-preview
version	string	否	模型版本号，如 1.0
displayName	string	否	模型的显示名称
description	string	否	模型的详细描述
inputTokenLimit	number	否	模型支持的最大输入 token 数量
outputTokenLimit	number	否	模型支持的最大输出 token 数量
supportedGenerationMethods	string[]	否	支持的生成方法，如 generateContent、countTokens
temperature	number	否	默认温度参数
topP	number	否	默认 top-p 参数
topK	number	否	默认 top-k 参数

按供应商过滤

GET/gemini/v1beta/models/{provider}

使用 GET /gemini/v1beta/models/{provider} 端点可以只返回特定供应商的模型。

支持的供应商

googledeepseekzhipuyi

# 列出 Google 提供商的所有模型
curl https://api.mintcloud.ai/gemini/v1beta/models/google \
  -H "x-goog-api-key: $MINTCLOUD_API_KEY"

获取模型详情

GET/gemini/v1beta/models/{provider}/{model_id}

使用 GET /gemini/v1beta/models/{provider}/{model_id} 端点可以获取特定模型的详细信息。

# 获取特定模型详情
curl https://api.mintcloud.ai/gemini/v1beta/models/google/gemini-3.1-flash-lite-preview \
  -H "x-goog-api-key: $MINTCLOUD_API_KEY"

响应格式

{
  "name": "models/gemini-3.1-flash-lite-preview",
  "version": "1.0",
  "displayName": "Gemini 3.1 Flash Lite",
  "description": "轻量级快速响应模型，适合高并发场景",
  "inputTokenLimit": 100000,
  "outputTokenLimit": 8192,
  "supportedGenerationMethods": ["generateContent", "countTokens"],
  "temperature": 0.9,
  "topP": 0.95,
  "topK": 40
}

支持的模型

gemini-3.1-flash-lite-previewgemini-3.1-flashgemini-3.1-progemini-3.0-flashgemini-2.0-flashgemini-2.0-flash-exp