# 查询模型目录与运行状态

浏览模型能力和报价，查看单个模型的健康检查结果，或比较最近一小时的运行指标。目录可见不等于调用凭据已获授权；实际调用前还需[查询可调用模型](../../../../reference/api/genesis/models.md)。

## 前提条件

查询当前用户可见的模型目录和运行状态时，准备个人访问令牌。公开模型目录和公开模型概况不需要认证。有关认证和查询范围，请参阅[使用与监测](../../../../reference/api/genesis/management/index.md)。

## 调用顺序

1. 需要浏览公开模型时，查询公开模型目录；只需模型数量和兼容调用入口时，查询公开模型概况。这两个查询可以独立使用。
2. 需要当前用户可见的模型信息时，查询模型目录。构建目录筛选界面时，再按需查询筛选项；只需候选列表时，查询模型选择项。
3. 检查单个模型时，使用模型目录返回的目录记录标识查询健康状态，查看汇总状态和最近的通道检查结果。
4. 需要比较模型运行情况时，查询模型运行状态，查看最近一小时的请求量、耗时和错误率。

## API 操作

### 浏览模型目录

| 要完成的事 | API 操作 | 何时使用或确认什么 |
| --- | --- | --- |
| 浏览当前用户可见模型 | [查询模型目录](../../../../reference/api/genesis/management/models/list-models.md) | 获取模型能力、报价和目录记录标识。 |
| 浏览公开模型 | [查询公开模型目录](../../../../reference/api/genesis/management/models/list-public-models.md) | 无需认证即可查看已启用的公开模型。 |
| 获取候选模型 | [查询模型选择项](../../../../reference/api/genesis/management/models/list-select-options.md) | 为模型选择控件取得候选项。 |
| 获取目录筛选项 | [查询模型筛选项](../../../../reference/api/genesis/management/models/get-filter-options.md) | 查看模型类型、系列及报价状态的数量。 |
| 查看公开概况 | [查询公开模型概况](../../../../reference/api/genesis/management/models/get-public-overview.md) | 获取公开模型数量和兼容调用入口。 |

### 检查健康和运行指标

| 要完成的事 | API 操作 | 何时使用或确认什么 |
| --- | --- | --- |
| 检查单个模型 | [查询模型健康状态](../../../../reference/api/genesis/management/models/get-model-health.md) | 使用目录记录标识查看健康检查结果。 |
| 比较近期运行情况 | [查询模型运行状态](../../../../reference/api/genesis/management/monitoring/get-model-status.md) | 查看最近一小时的请求量、耗时、错误率和健康状态。 |

## 结果确认

在[查询模型目录](../../../../reference/api/genesis/management/models/list-models.md)的结果中确认目标模型，再通过[查询模型健康状态](../../../../reference/api/genesis/management/models/get-model-health.md)检查同一目录记录。运行指标反映近期调用情况，不替代调用凭据的模型授权检查。

## 限制和注意事项

- 模型目录记录标识与模型调用所用的名称不是同一个用途，按对应动作页选择标识。
- 目录、选择项和筛选项支持的筛选条件并不完全相同，不能直接复用全部筛选参数。
- 模型运行状态使用最近一小时的统计范围；其他筛选条件影响指标聚合，不会据此过滤外层启用模型集合。

## 下一步

- [查询可调用模型](../../../../reference/api/genesis/models.md)
- [查询与排查请求日志](request-logs.md)