# 模型状态

<a id="model-status"></a>

<a id="模型状态"></a>

## 接口说明

`GET /admin/api/model-status 无需 Key`

返回当前模型的公开可用性快照，适合状态页、自动切换模型和调用前健康检查。该接口不需要登录，也不需要 `Authorization` 请求头。

公开接口，可直接跨页面调用。服务端状态快照最多缓存 5 分钟；客户端可按需轮询，建议间隔不少于 60 秒。

operationaldegradedoutagemaintenanceunknown

 字段 | 类型 | 说明 |
| --- | --- | --- |
 `data` | `array` | 当前公开模型的状态列表。 |
 `data[].model_id` | `string` | 模型配置 ID。 |
 `data[].name` | `string` | 模型显示名称。 |
 `data[].alias` | `string` | 公开别名；未设置时省略。 |
 `data[].description` | `string` | 公开模型说明；为空时省略。 |
 `data[].type` | `string` | 模型类型：text、image 或 video。 |
 `data[].provider` | `string` | 模型所属服务类型。 |
 `data[].prices` | `object` | 公开价格表：图片按分辨率、视频按分辨率及 video\_billing\_mode（per\_second 按秒、per\_request 按次）、文本按次展示积分价格；按 token 模型以 text\_pricing 中的输入、输出、缓存价格为准。 |
 `data[].status` | `string` | operational、degraded、outage、maintenance 或 unknown。 |
 `data[].status_reason` | `string` | 当前状态的简要原因。 |
 `data[].availability_7d` | `number \| null` | 最近 7 天可用率，范围 0 到 1；无数据时为 null。 |
 `data[].samples_7d` | `integer` | 最近 7 天计入可用率的样本数量。 |
 `data[].avg_ms` | `integer \| null` | 最近 24 小时平均处理耗时，单位毫秒。 |
 `data[].last_checked_at` | `string \| null` | 最近检测时间，RFC 3339 格式。 |
 `data[].updated_at` | `string` | 该模型状态记录的更新时间，RFC 3339 格式。 |
 `updated_at` | `string` | 本次公开状态快照的更新时间。 |

 **模型状态**  `GET /admin/api/model-status · 无需 API Key`

```bash
curl https://y.junlistudio.com/admin/api/model-status
```