控制台与用量

本文档说明控制台看板（Dashboard）与用量日志（Usage Logs）的使用。两者分别用于宏观监控与逐条排查。

​

控制台看板

控制台看板是登录后的首页，用于宏观掌握账户使用情况。通常包含以下信息：

​

余额与消费概览

• 当前余额：账户剩余可用额度。
• 消费趋势：近期（如最近 7 天或 30 天）的花费曲线，可直观观察消费变化。

​

用量统计

• 调用次数：一段时间内发起的请求总数。
• Token 用量：消耗的输入与输出 Token 总量。
• 模型分布：各模型的用量占比排行，可用于识别主力模型与高消耗来源。

看板适用于回答宏观问题，如整体花费情况、主要使用的模型及消费是否出现异常波动。

​

用量日志

用量日志是最重要的排查工具，逐条记录每次调用的详细信息，是排查扣费异常与调用失败的第一现场。

​

日志内容

每条记录通常包含以下字段：

​

使用场景

场景一：扣费异常 按时间查找对应调用，查看输入与输出 Token 数。通常为上下文过长（历史消息多）或输出过长所致。 场景二：调用失败 查找失败记录，读取「失败原因」字段。该字段通常直接说明问题原因（如余额不足、模型无权限、参数错误或上游故障）。 场景三：疑似盗刷 如发现未经授权的调用或某密钥用量异常，可能为密钥泄露。应立即在密钥页面删除并重新创建。 场景四：核对账单 将某段时间内的每次消耗汇总，与钱包中的消费记录核对。

​

配合使用

建议的监控习惯：

1. 定期查看看板，观察消费趋势。如发现某日消费异常飙升，进入用量日志按时间定位具体调用。
2. 针对高消耗调用，考虑优化措施（如更换较低价格的模型、缩短上下文、限制输出长度）。
3. 调用出错时，第一时间查阅用量日志中的失败原因，比盲目试错更高效。

​

相关文档

• 付款与账单：充值、余额与账单。
• 模型与定价：费用计算规则。
• 账户与 API 密钥：密钥管理与安全。