用户手册
17. 查看用量并控制成本
完整版章节。内容按 2026.10 主线代码核对；具体入口以当前许可、账号权限和交付环境为准。
本章说明成员查看本人用量、管理员查看全租户用量与费用的入口。逐项分析方法见第 18 章，费用与配额告警的配置见第 22.2 节。
17.1 查看个人用量
入口：能力中心「首页」，在左侧导航「用量」分组中选择分区。所有成员均可使用，页面只显示本人的数据，不需要加购许可模块。
| 分区 | 内容 |
|---|---|
| 「使用情况」 | 「最近 180 天使用情况」：「模型调用次数」「MCP 调用」「消息数」「累计 Token 数」及与前 180 天的对比；「模型使用率」「MCP 使用率」等排行；「最近一年活跃度」热力图；以及「今日 Token 消耗」「当月 Token 消耗」等汇总 |
| 「模型用量」 | 按「今天」「最近 7 天」「本月」统计（默认「本月」），可按「API 密钥」「模型服务」「模型」「计费归属」筛选；显示「可用模型服务」「可用 API 密钥」数量，以及「消费金额」「模型调用次数」「总 Token」「平均单次成本」，「消费趋势」与「模型占比」图表；「消费明细」按「日期」「API 密钥」「模型服务」「模型」「计费归属」列出「调用次数」「Token」「金额」 |
| 「调用日志」 | 「按调用」或「按回答」查看逐次模型与 MCP 调用；时间范围可选「最近 24 小时」「最近 7 天」「最近 30 天」或「自定义范围」，可按「调用类型」「状态」「计费归属」筛选，在搜索框中按模型、调用方、Request ID、Trace ID 或错误搜索，并可「导出记录」为 CSV |
使用说明：
- 核对近期消耗时，先在「模型用量」选择统计范围，再按 API 密钥或模型服务筛选，确认消耗来自哪一把 Key、哪一项服务。
- 金额按调用发生时的单价计算。部分调用缺少定价时，页面显示「费用不完整」或「费用缺失」，金额与图表只统计已记录费用的调用。
- 需要核对单次调用时，进入「调用日志」，按时间和状态筛选后查看调用详情。
限制：「模型用量」的「今天」「最近 7 天」「本月」由服务端按账号档案中记录的时区划分自然日，未记录时区时按 UTC 计算。「偏好设置」中的「时区」只影响本浏览器的时间显示，不改变该统计窗口。
17.2 管理员查看用量与成本
入口：「管理控制台 → 概览 → 概览」，默认打开「网关总览」页签。该页按所选时间范围和数据范围汇总全租户的网关调用，常用内容如下：
- 「网关运营指标」：「总消耗费用」「总 Token 消耗量」「输入 / 输出 Token」「缓存命中 Token」「首字延迟」「生成速率」「模型调用交付成功率」「MCP 工具调用」「网关耗时 P95」「端到端 P99」「活跃用户」等指标，附与上一周期的对比。
- 「各模型费用消耗走势」「Token 消耗趋势（输入 vs 输出）」「Prompt 缓存命中走势」「请求耗时构成」「请求结果归因」「小时热力」「调用流向」等趋势与归因面板。
- 「模型费用排行」「部门费用排行」「人员费用排行」三张费用排行，以及「客户端」「工具调用」「预算」面板。
前提与限制：
- 租户管理员与「运营」「系统管理员」「安全管理员」「审计员」角色可查看；「财务」角色只能看到运营指标、各模型费用走势与三张费用排行；「预算」面板只对租户管理员与「系统管理员」显示。侧栏的「概览」菜单对租户管理员与「系统管理员」显示，其他角色通过概览页面地址进入。
- 读取用量分析数据的面板（包括运营指标、Token、缓存、耗时、热力、调用流向与费用排行）需要许可包含「FinOps」模块。未授权时这些面板整格隐藏，页面仅保留告警、工具调用与 MCP 相关面板。
- 费用依赖模型定价。未配置定价的调用在排行中计为「未定价次数」，不计入金额。
建议每周核对：费用与 Token 是否突增，「模型调用交付成功率」是否下降，「端到端 P99」是否恶化，某一模型、部门或人员的费用占比是否异常，新上线的模型服务是否有实际调用。发现异常时，点击排行或归因中的行，页面会切换到「网关请求」页签并带上对应筛选，用于核对单次调用。