# 查询可用模型

查询当前密钥可见的模型。

`GET /v1/models`

<a id="authentication"></a>

## 鉴权

使用 Authorization: Bearer YOUR_API_KEY。所选模型须在该密钥分组内开放；JSON 请求使用 Content-Type: application/json。

<a id="parameters"></a>

## 参数



| 字段 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| Authorization | header | 必填 | 本站 API 密钥；无需请求体。 |

<a id="request"></a>

## 请求示例



```
export OHGROK_API_KEY='YOUR_API_KEY'

curl --fail-with-body --silent --show-error \
  'https://api.ohgrok.com/v1/models' \
  -H "Authorization: Bearer $OHGROK_API_KEY"
```

<a id="response"></a>

## 响应结构

读取 data[].id，在后续请求中使用准确 ID。列表受密钥与分组影响，不保证上游实时容量。

```
{"object":"list","data":[{"id":"grok-4.5","object":"model"}]}
```

<a id="errors"></a>

## 错误处理

结合 HTTP 状态与返回的错误信息排查。鉴权或模型权限错误先检查密钥与分组；额度或限流错误检查余额及上游限制；超时时保留已有任务 ID。

- [排查一次请求](/zh/docs/errors/)