使用历史与消耗排查
页面入口
使用历史页位于 /dashboard/usage。
该页面用于查看模型调用明细、筛选日期、筛选 Provider，并排查消耗和错误。
查询范围
页面默认按本地日期选择开始日期和结束日期。用户可以使用日期选择器调整范围。
查询时系统会按天转换为：
- 开始时间：当天 00:00:00。
- 结束时间：当天 23:59:59。
如果看不到预期记录，先确认日期范围是否包含请求发生时间。
Provider 筛选
页面支持：
- 全部。
- OpenAI。
- Anthropic。
- Gemini。
筛选只影响当前列表展示，不会修改 API Key 或调用配置。
明细字段
使用历史通常展示：
- 请求时间。
- Provider。
- API Key 名称或 Token 名称。
- 模型名称。
- 渠道链路。
- 输入 Token。
- 输出 Token。
- 缓存 Token、缓存读取、缓存写入。
- 请求耗时。
- 是否流式请求。
- 请求 ID。
- 输入费用、输出费用和总费用。
字段具体展示以页面当前表格为准。
渠道链路
如果 API Key 绑定了多个分组，使用历史可能展示按顺序形成的渠道链路。链路可以帮助判断实际请求走到了哪个通道，以及是否发生过切换。
成本排查
发现余额下降较快时，按顺序检查：
- 日期范围是否正确。
- 是否集中在某个 Provider。
- 是否集中在某个模型。
- 是否集中在某个 API Key。
- 是否存在异常高的输出 Token。
- 是否存在高频循环调用。
- 是否有缓存创建或缓存读取成本。
调用失败排查
如果客户端调用失败：
- 确认余额是否大于 0。
- 确认 API Key 没有删除或更换。
- 确认 Base URL 和客户端协议匹配。
- 确认模型名正确。
- 确认 Provider 分组仍可用。
- 到使用历史查看是否出现对应请求和错误。
- 提交工单时附上请求时间、Provider、模型、Key 后四位和请求 ID。
数据加载说明
页面会批量读取分页数据，并在浏览器会话中短时间缓存结果。刷新页面或等待缓存过期后会重新请求。
如果当前部署没有接入使用历史能力，页面会显示只读占位，并提示联系运维或客服协助导出。