---
title: 查询可用模型
description: 获取当前 API Key 所属分组可见的模型目录。
api: "GET /v1/models"
---

<RequestExample>
```bash cURL
curl https://sub.vcnovb.cn/v1/models \
  -H "Authorization: Bearer $VC_API_KEY"
```
</RequestExample>

<ResponseExample>
```json 200 · 成功
{
  "object": "list",
  "data": [
    {"id": "gpt-5.2", "object": "model", "created": 0, "owned_by": "openai"}
  ]
}
```
</ResponseExample>

## 如何使用结果

将 `data` 中的模型 `id` 填入生成请求的 `model` 字段。

返回列表对应当前 Key 所绑定分组的可用模型。模型价格可在[模型广场](https://sub.vcnovb.cn/model-plaza)查看。

## 返回字段

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `object` | string | 列表类型，值为 `list` |
| `data` | array | 模型列表 |
| `data[].id` | string | 调用时使用的模型 ID |
| `data[].object` | string | 对象类型，值为 `model` |
| `data[].owned_by` | string | 模型所属方 |

修改 Key 分组后，重新查询模型列表或刷新客户端的模型选择器。