# Gemini Models API — 模型查询

Source: https://ofox.io/zh/docs/api/gemini/models

通过 Gemini 原生协议查询 OfoxAI 平台上可用的模型。响应格式遵循 Google GenAI API 规范（`name`、`displayName`、`inputTokenLimit` 等 camelCase 字段）。

Models API 是公开接口，无需 API Key 即可调用。此端点返回所有可通过 Gemini 协议调用的模型，不仅限于 Google 系列。

## 列出所有模型

```http
GET https://api.ofox.io/gemini/v1beta/models
```

### 请求示例

```bash filename="Terminal"
curl https://api.ofox.io/gemini/v1beta/models
```

### 响应格式

```json
{
  "models": [
    {
      "name": "models/google/gemini-3.8-flash",
      "version": "001",
      "displayName": "Google: Gemini 3.8 Flash",
      "description": "Gemini 3.8 Flash is Google's most intelligent Flash model, with significant gains over 3.7 Flash across software engineering, agentic tasks, and multi-step reasoning. All input modalities (text/image/video/audio) unified pricing; batch tier at 50% discount. Thinking model with configurable levels. 1M context. Released September 2, 2026.",
      "inputTokenLimit": 1000000,
      "outputTokenLimit": 65536,
      "supportedGenerationMethods": [
        "generateContent",
        "countTokens"
      ],
      "ownedBy": "google",
      "canonicalSlug": "gemini-3.8-flash",
      "contextLength": 1000000,
      "architecture": {
        "modality": "text+image+audio+file->text",
        "input_modalities": [
          "text",
          "image",
          "audio",
          "file"
        ],
        "output_modalities": [
          "text"
        ],
        "tokenizer": "gemini",
        "instruct_type": null
      },
      "pricing": {
        "prompt": "0.0000015",
        "completion": "0.0000075",
        "audio": "0.0000015",
        "input_cache_read": "0.00000015",
        "input_cache_write": "0.000000083",
        "input_cache_write_1h": "0.000001",
        "input_cached_audio": "0.00000015",
        "web_search": "0.014"
      },
      "topProvider": {
        "context_length": 1000000,
        "max_completion_tokens": 65536,
        "is_moderated": false
      },
      "supportedParameters": [
        "temperature",
        "top_p",
        "max_tokens",
        "stop",
        "tools",
        "tool_choice",
        "response_format",
        "reasoning"
      ],
      "expirationDate": null,
      "isDeprecated": false,
      "aliases": [
        "gemini-3.8-flash"
      ]
    }
  ]
}
```

### 与 OpenAI 协议的字段差异

| 字段 | OpenAI 协议 | Gemini 协议 |
|------|------------|-------------|
| 列表键名 | `data` | `models` |
| 模型标识 | `id` | `name`（带 `models/` 前缀） |
| 名称 | `name` | `displayName` |
| 上下文长度 | `context_length` | `inputTokenLimit` + `contextLength` |
| 最大输出 | `top_provider.max_completion_tokens` | `outputTokenLimit` |
| 命名风格 | snake_case | camelCase |

## 按供应商过滤模型

```http
GET https://api.ofox.io/gemini/v1beta/models/{provider}
```

### 路径参数

| 参数 | 类型 | 说明 |
|------|------|------|
| `provider` | string | 供应商标识，如 `google`、`anthropic`、`openai` |

### 请求示例

```bash filename="Terminal"
# 仅列出 Google 系列模型
curl https://api.ofox.io/gemini/v1beta/models/google
```

### 响应格式

返回格式与列出所有模型一致，`models` 数组仅包含指定供应商的模型。

## 获取模型详情

```http
GET https://api.ofox.io/gemini/v1beta/models/{provider}/{model_id}
```

### 路径参数

| 参数 | 类型 | 说明 |
|------|------|------|
| `provider` | string | 供应商标识，如 `google` |
| `model_id` | string | 模型名称，如 `gemini-3.8-flash` |

### 请求示例

```bash filename="Terminal"
curl https://api.ofox.io/gemini/v1beta/models/google/gemini-3.8-flash
```

### 响应格式

返回单个 Model 对象，结构与列表接口中的对象一致。