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

# 列出模型

> GET /v1/models —— 查询当前 Key 可用模型清单

返回当前 API Key 有权限调用的所有模型。

## 请求

```bash theme={null}
curl https://openp.ai/v1/models \
  -H "Authorization: Bearer $OPENPAI_API_KEY"
```

无查询参数。

## 响应

```json theme={null}
{
  "object": "list",
  "data": [
    {
      "id": "gpt-5.5",
      "object": "model",
      "created": 1715750400,
      "owned_by": "openai"
    },
    {
      "id": "gpt-5.4-mini",
      "object": "model",
      "created": 1715750400,
      "owned_by": "openai"
    },
    {
      "id": "claude-opus-4-8",
      "object": "model",
      "created": 1715750400,
      "owned_by": "anthropic"
    }
  ]
}
```

## 获取单个模型

```bash theme={null}
curl https://openp.ai/v1/models/gpt-5.5 \
  -H "Authorization: Bearer $OPENPAI_API_KEY"
```

返回:

```json theme={null}
{
  "id": "gpt-5.5",
  "object": "model",
  "created": 1715750400,
  "owned_by": "openai"
}
```

## 范围

* 列表受 **令牌的模型范围设置** 限制 —— 如果创建令牌时设置了白名单,这里只返回白名单内的模型。
* 受 **用户分组** 影响:仅返回当前分组可访问的模型。

## 用途

* 客户端启动时拉取一次,缓存到本地,作为下拉菜单的可选列表。
* 在自建网关 / 中转代理中转发该接口,供下游用户查询。