> ## Documentation Index
> Fetch the complete documentation index at: https://docs.geeknow.top/llms.txt
> Use this file to discover all available pages before exploring further.

# 模型列表

> 查询当前 API Key 可用模型，兼容 OpenAI、Claude 与 Gemini 风格。

# 模型列表

查询可用模型列表。路由会根据请求头判断兼容格式：默认返回 OpenAI 风格；带 `x-api-key` 和 `anthropic-version` 时走 Claude 风格；带 `x-goog-api-key` 或 `key` 查询参数时走 Gemini 风格。

<Info>
  如果你只是想先知道“系统里大概有哪些文本模型名字”，不想立刻发接口请求，可以先看 [文本模型支持矩阵](/api-reference/texts/model-matrix) 里的“常见模型名称示例”。但真正对你当前 key 可用的模型，仍以本页接口返回为准。
</Info>

## 常见模型名称示例

| 家族           | 常见模型名                                                                               |
| ------------ | ----------------------------------------------------------------------------------- |
| GPT / OpenAI | `gpt-5.5`、`gpt-5.4`、`gpt-5.4-high`、`gpt-5.4-medium`、`gpt-5.4-xhigh`、`gpt-5`         |
| Claude       | `claude-fable-5`、`claude-opus-4-8`、`claude-sonnet-5`、`claude-haiku-4-5-20251001`    |
| Gemini       | `gemini-3.5-flash`、`gemini-3.1-pro-preview`、`gemini-3-pro-preview`、`gemini-2.5-pro` |
| DeepSeek     | `deepseek-v4-flash`、`deepseek-v4-pro`                                               |
| Qwen         | `qwen-max`、`qwen-plus`、`qwen-turbo`、`qwen3-max`                                     |

<Warning>
  模型列表会随渠道和账户权限变化。不要把上表当成完整模型清单，也不要假设每个模型都支持所有参数；上游官方最新模型只有在本接口返回后，才表示当前 API Key 可用。上线前请用当前 API Key 调用本页接口确认。
</Warning>

## 路径

| Method | Path                    | 说明                          |
| ------ | ----------------------- | --------------------------- |
| `GET`  | `/v1/models`            | OpenAI/Claude/Gemini 兼容模型列表 |
| `GET`  | `/v1/models/{model}`    | 查询单个模型                      |
| `GET`  | `/v1beta/models`        | Gemini 原生模型列表               |
| `GET`  | `/v1beta/openai/models` | Gemini 下的 OpenAI 兼容模型列表     |

## 请求示例

<RequestExample>
  ```bash theme={null}
  curl https://www.geeknow.top/v1/models \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```
</RequestExample>

### Claude 风格

```bash theme={null}
curl https://www.geeknow.top/v1/models \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01"
```

### Gemini 风格

```bash theme={null}
curl https://www.geeknow.top/v1beta/models \
  -H "x-goog-api-key: YOUR_API_KEY"
```

## 响应示例

<ResponseExample>
  ```json 200 theme={null}
  {
    "object": "list",
    "data": [
      {
        "id": "gpt-5.5",
        "object": "model",
        "created": 1735689600,
        "owned_by": "openai"
      },
      {
        "id": "claude-sonnet-5",
        "object": "model",
        "created": 1735689600,
        "owned_by": "anthropic"
      }
    ]
  }
  ```

  ```json 401 theme={null}
  {
    "error": {
      "message": "Invalid API key provided",
      "type": "invalid_request_error",
      "param": "",
      "code": "invalid_api_key"
    }
  }
  ```

  ```json 429 theme={null}
  {
    "error": {
      "message": "当前请求频率过高，请稍后再试",
      "type": "new_api_error",
      "param": "",
      "code": "too_many_requests"
    }
  }
  ```

  ```json 500 theme={null}
  {
    "error": {
      "message": "bad response body",
      "type": "new_api_error",
      "param": "",
      "code": "bad_response_body"
    }
  }
  ```
</ResponseExample>

### 查询单个模型

```bash theme={null}
curl https://www.geeknow.top/v1/models/gpt-5.5 \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## 相关接口

* [Chat Completions（非流式）](./chat-completions-non-stream)
* [Gemini 原生格式](./gemini-native)