用量画像

用量画像是一个可视化的用量分析面板，帮助管理者和成员从多个维度深入了解 API 调用行为，包括 Token 消耗趋势、时段分布、模型偏好、来源分析等。

开放范围

当前用量画像功能面向部分组织内测开放。已开放组织的成员可使用，个人空间暂不支持。

功能入口

进入组织工作台，左侧导航选择 治理 → 用量画像。

权限说明

角色	查看范围
组织拥有者 / 管理员	可查看组织内所有成员的用量画像，并切换查看不同成员
团队负责人	可查看本人及所负责团队成员的用量画像
普通成员	仅可查看本人的用量画像

功能模块

用量画像包含以下分析模块：

概览指标

页面顶部展示所选时段内的核心指标概览：

指标	说明
总 Token 消耗	时段内所有成功请求的 Token 总量
累计请求	成功请求的总次数
输入 Token	输入侧 Token 总量
输出 Token	输出侧 Token 总量
缓存创建	缓存创建的 Token 量
缓存命中量	缓存命中的 Token 量
缓存命中率	缓存命中占比（带进度条可视化）
累计消费	时段内产生的总费用

用量趋势

以折线图展示 Token 消耗和费用的时间趋势，支持：

• 输入 Token / 输出 Token / 缓存命中 Token 分维度展示
• 费用趋势（双 Y 轴：Token 用量 + 费用）
• 可切换时间范围：近 7 天 / 近 30 天 / 近 90 天

时段热力图

以 24×7 热力图展示调用时段分布，帮助识别使用模式：

• 横轴：一天中的 24 小时
• 纵轴：一周中的 7 天
• 颜色深浅：Token 用量或调用次数
• 统计指标：深夜占比（22:00-06:00）、周末占比
• 可切换范围：周 / 月 / 季 / 年

模型分布

展示使用的模型分布情况：

• 按 Token 消耗、请求次数或成本排序
• 各模型占比可视化
• 支持切换统计维度：Token 消耗 / 请求次数 / 成本

来源分析

分析 API 调用的来源信息：

• IP 地理位置分布
• 企业 / 非企业 / 代理 IP 分类
• 调用次数与 Token 用量统计

工具分布

展示不同客户端工具的使用情况：

• UA 工具（如 Cursor、VS Code 等）的调用分布
• 直接 API 调用占比
• 按输入 Token、输出 Token 或请求量统计

Token 长度分布

展示输入和输出 Token 长度的请求次数分布：

• 中位数、P95、最大值统计
• 帮助识别异常长的请求

操作说明

切换时间范围

页面右上角可选择时间范围：

• 近 7 天：查看最近一周的用量数据
• 近 30 天（默认）：查看最近一个月的用量数据
• 近 90 天：查看最近三个月的用量数据

切换查看成员

对于组织管理员和团队负责人，页面顶部提供成员选择器：

1. 点击成员下拉选择框
2. 搜索或选择目标成员
3. 页面自动刷新为该成员的用量画像

团队负责人仅可查看本人及所负责团队的成员。管理员可查看组织内所有成员。

查看详情

• 悬停图表中的数据点可查看具体数值
• 点击模型分布图例可隐藏/显示特定模型
• 热力图支持切换 Token 用量或调用次数维度

使用场景

场景	使用方式
排查异常调用	通过时段热力图发现非工作时间的异常调用峰值
优化缓存效率	查看缓存命中率，评估 Prompt 缓存配置效果
成本归因分析	通过模型分布和费用趋势，定位高成本模型
团队用量对比	管理员切换不同成员，对比团队内的用量分布
安全审计	通过来源分析，检查是否有非授权 IP 的调用