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

# 控制台与用量

> 查看用量总览、趋势图、API 活动记录和账户活动记录。

“控制台与用量”对应平台侧边栏中的“用量”页面，用于查看当前账户的调用趋势和近期活动。这里展示的是你自己账号产生的记录；余额充值和账单流水请到 [付款与账单](/zh/platform/billing) 查看。

## 页面概览

页面顶部展示当前时间范围内的四个指标：

| 指标      | 含义                     |
| ------- | ---------------------- |
| 总用量     | 当前时间范围内 API 调用消耗的额度    |
| 请求数     | 当前时间范围内的 API 请求次数      |
| 总 Token | 输入 Token 与输出 Token 的合计 |
| API 密钥  | 当前时间范围内产生调用的密钥数量       |

这些指标只统计 API 调用记录。网页“对话”中产生的测试请求会使用平台内部虚拟密钥，页面中可能显示为类似 `playground-key` 的密钥标识。

## 时间范围与图表

指标下方可以切换统计范围和图表维度：

| 控件                          | 作用                         |
| --------------------------- | -------------------------- |
| Day / Week / Month / Custom | 切换最近 1 天、7 天、30 天，或输入自定义天数 |
| Hour / Minute               | 切换图表统计粒度                   |
| API Key / Model             | 按 API 密钥或模型聚合图表数据          |

页面包含四个图表：

* 总用量：查看额度消耗随时间变化。
* 调用趋势：查看请求量随时间变化。
* 调用次数分布：查看不同密钥或模型的调用占比。
* 调用次数排行：找出调用次数最高的密钥或模型。

<Tip>
  当你需要定位成本来源时，先按 Model 查看高消耗模型，再按 API Key 查看是哪个密钥产生了请求。
</Tip>

## 最近活动

页面底部的“最近活动”展示最近记录，分为两个视图：

| 视图    | 内容                                                         |
| ----- | ---------------------------------------------------------- |
| API   | API 调用记录，包括时间、API 密钥、模型、输入 Token、输出 Token、缓存命中、总 Token 和消耗 |
| Other | 账户活动记录，例如充值、管理操作、系统记录、错误、退款或登录记录                           |

API 记录适合排查模型调用和成本；Other 记录适合查看账户层面的活动。

## 缓存命中

当模型请求使用了缓存能力时，API 记录会在 Tokens 位置展示缓存相关数据：

| 标识     | 含义                                 |
| ------ | ---------------------------------- |
| Cache↓ | 读取缓存的 Token 数，也就是本次命中的缓存内容         |
| Cache↑ | 写入缓存的 Token 数，可能按模型区分 5 分钟或 1 小时缓存 |

打开单条记录详情后，可以查看更完整的 Token 拆分，包括输入、输出、缓存读取和缓存写入。并非所有模型都会产生缓存数据；没有命中或模型不支持缓存时，该记录不会显示缓存行。

## 查看更多与下载

点击“View more”可以打开活动历史窗口。API 活动历史支持：

* 选择开始日期和结束日期。
* 按 API 密钥筛选记录。
* 分页查看更多记录。
* 下载当前筛选范围内的 API 记录文本文件；如果只想下载某一把密钥的记录，先在密钥筛选项中输入该密钥名称，再点击下载。

下载文件会包含时间、API 密钥、模型、输入 Token、输出 Token、缓存 Token、总 Token 和消耗，适合本地留档或与团队核对调用情况。

## 常见排查路径

<AccordionGroup>
  <Accordion title="余额减少但不知道来源">
    先在本页选择对应时间范围，按 Model 查看调用分布；再切换到 API Key，确认是哪个密钥产生了请求。需要核对充值或余额变动时，再查看 [付款与账单](/zh/platform/billing)。
  </Accordion>

  <Accordion title="某个密钥疑似异常调用">
    在图表中切换到 API Key 聚合，查看该密钥的调用次数和用量趋势。若发现陌生时间段或异常请求量，请到 [API 密钥](/zh/platform/account-and-keys) 删除或重新创建密钥。
  </Accordion>

  <Accordion title="想导出一段时间的调用记录">
    打开“最近活动”的“View more”，在 API 视图中选择日期范围，然后点击 Download。若只需要某一把 API 密钥的记录，先按密钥筛选后再下载。导出的文本文件只包含 API 活动记录，不包含充值、登录等 Other 活动。
  </Accordion>

  <Accordion title="如何确认缓存是否命中？">
    查看 API 记录的 Tokens 列。出现 Cache↓ 表示本次读取了缓存；出现 Cache↑ 表示本次写入了缓存。打开记录详情可以查看缓存读取、缓存写入和普通输入输出 Token 的拆分。
  </Accordion>

  <Accordion title="为什么看不到请求失败原因？">
    当前用量总览主要展示账户侧的统计和活动摘要。若你需要查看更完整的请求错误信息，请结合客户端返回的错误内容、请求时间、模型名称和 API 密钥一起排查。
  </Accordion>
</AccordionGroup>

## 相关文档

* [付款与账单](/zh/platform/billing)
* [API 密钥](/zh/platform/account-and-keys)
* [模型广场与定价](/zh/overview/models-and-pricing)