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

# Models

> 查询当前 Token 可以使用的模型清单，了解可用能力与属性。

`GET /v1/models` 返回与当前 Token 绑定的所有模型，包含模型 ID、类型、可用状态等信息。

## 请求示例（cURL）

```bash theme={null}
curl "$BASE_URL/v1/models" \
  -H "Authorization: Bearer $TOKEN"
```

## 业务场景

* 动态能力探测：根据返回的模型列表决定是否显示某些功能入口。
* 监控与灰度：结合 HingNet AI 控制台的配额策略，可在模型级别做灰度发布。
* SDK 初始化：许多第三方 SDK 允许通过提前拉取模型列表进行本地缓存，避免硬编码。