# 用量归因与分析

来源: https://platform.lyrouter.com/ai_gateway/docs/analytics
更新日期: 2026-10-14

用量分析按工作空间汇总一段时间内的请求数、Token、缓存命中率和费用，并按 API Key、部门、用户、模型和意图拆分，用来回答「谁在用、用在哪些模型上、花了多少」。用量按 API Key 归到 Key 的创建人及其部门；普通成员只能看到自己创建的 Key。费用以人民币显示：平台请求按实际扣费金额计算，BYOK 按服务商成本计算。核对单次请求请看[日志](https://platform.lyrouter.com/ai_gateway/docs/logs)，核对 Credits 扣费请看[消费明细](https://platform.lyrouter.com/ai_gateway/docs/billing)。

## 打开用量分析

进入工作空间，在左侧「用量日志」分组点 **用量分析**。数据范围是当前工作空间；要看组织下全部工作空间的合计，回到控制台的 **概览** 页。

页面顶部有三个筛选项，所有标签页都跟随它们：

| 筛选项 | 选项 | 说明 |
| --- | --- | --- |
| 「时间范围」 | 今天、昨天、近 7 天、近 30 天、近 90 天、自定义 | 指标卡同时显示与上一个等长周期的对比 |
| 「模态」 | 文本、图片生成、视频生成 | 文本按 Token 统计；图片按张、视频按秒统计，用量和费用同时显示 |
| 「统计视角」 | 用量、费用 | 只在「文本」下可用，切换后各标签页改为按费用展示 |

数据为近实时，页面加载或点 **刷新** 时重新拉取。刚发出的请求如果还没出现，稍后刷新即可。

（截图：用量分析先选时间范围、模态和统计视角，总览显示 Token、请求、成功率、缓存命中率和活跃 Key。）

## 谁能看到哪些数据

| 身份 | 能看到的用量 | 「按部门」「按用户」 |
| --- | --- | --- |
| 个人版的账号管理员 | 工作空间的全部用量 | 不显示 |
| 团队版、企业版的当前账号管理员 | 工作空间的全部用量，含总览的「Top 部门」「Top 用户」 | 显示 |
| 普通成员（包括担任工作空间管理员的成员） | 只有自己创建的 API Key 的用量和费用 | 不显示 |

普通成员还没有创建过 API Key 时，页面没有数据。团队版和企业版的「按 API Key」明细带「创建者」列。

## 标签页

| 标签 | 内容 |
| --- | --- |
| 「总览」 | 指标卡、用量趋势，以及模型、服务商、客户端、意图分布和 Top 排行；「服务商分布」可按平台或 BYOK 来源筛选 |
| 「按 API Key」 | 各 Key 的用量趋势和明细，选中一个 Key 可下钻其模型、意图构成 |
| 「按部门」「按用户」 | 各部门、各用户的用量与下钻 |
| 「按模型」 | 分模型的用量趋势与明细，含服务商、来源、缓存命中率、成功率、「P95 首字延迟」和吞吐，覆盖平台与 BYOK 来源 |
| 「按意图」 | 开发调试、咨询解答等请求意图的占比与明细 |
| 「自定义统计」 | 自选分组和细分维度查询，并导出 CSV，见下文 |

「P95 首字延迟」只统计成功的流式请求。

## 用量指标怎么算

- **Token**：用量分析展示「输入（缓存未命中）」「输入（缓存命中）」「输出」三项，三项互不重叠，相加即 Token 总量。「显式缓存创建」不在用量分析中统计，请在[日志](https://platform.lyrouter.com/ai_gateway/docs/logs)详情中查看。
- **缓存命中率**：输入（缓存命中）÷（输入（缓存未命中）+ 输入（缓存命中）），按 Token 数加权。汇总行的命中率由合计 Token 算出，不是各行百分比的平均，所以 Token 多的行影响更大。提高命中率的方法见[降低成本与优化缓存](https://platform.lyrouter.com/ai_gateway/docs/cost-practice)。
- **请求总数与成功率**：HTTP 状态码小于 400 的请求算成功。被网关直接拒绝、没有发往上游的请求不计入请求数和成功率，例如 API Key 无效或过期、订阅过期、余额不足、限流、安全围栏拦截、模型未开通；这些请求可以在日志中查到。`GET /v1/models` 查询模型列表的请求也不计入。
- **Token 与活跃 Key**：只统计成功请求。「活跃 Key」显示为「区间内有成功调用的 Key 数 / 当前启用的 Key 数」。

## 费用视角

把「统计视角」切到「费用」后，页面说明为「以人民币查看 Token 费用：平台请求按客户实付金额计算（与账单同一口径），BYOK 按服务商成本计算。」总览的「Token 费用」卡片拆成三部分：

| 项目 | 含义 |
| --- | --- |
| 「平台 Token 费用」 | 平台请求实际扣除的 Credits，按每次请求结算时冻结的汇率换算成人民币，与消费明细逐条一致 |
| 「BYOK Token 费用」 | 按服务商价格估算的 BYOK 调用成本，由你直接向服务商支付，不从 Credits 扣除 |
| 「BYOK 订阅费用」 | 按订阅付费的 BYOK 凭证（例如 [Coding Plan](https://platform.lyrouter.com/ai_gateway/docs/coding-plan)）的订阅费，按天折算计入 |

- **BYOK 订阅费用不分摊**：它只计入工作空间的总额，不分到模型、API Key、部门、用户、意图或单次请求上，因此各维度的费用之和会小于总额。普通成员的费用不含这部分。
- **缺少价格的请求不计入**：个别请求缺少计费信息时按 0 计入合计，费用合计可能略低于实际。
- **较早的历史数据**：平台启用「按实付金额」统计之前的时间段，平台请求的金额是服务商成本估算，与账单不完全一致。
- **按模型拆分**：「按模型」在费用视角下列出输入费用、输出费用、缓存费用和请求固定成本。

## 用量归在谁名下

- **按 API Key 归因**：每次调用记在所用的 API Key 上，再归到 Key 的创建人和创建人的主部门。多人共用一个 Key 时，无法区分是谁发起的调用；需要按人核算时，为每个人分别创建 Key，见[创建工作空间与 API Key](https://platform.lyrouter.com/ai_gateway/docs/api-keys)。
- **共享 Key 单列**：可见范围是成员或全工作空间的共享 Key，其用量在「按用户」「按部门」中单列为「共享应用 · 未归属」，不归到任何人或部门名下。点这一行可以查看明细。
- **失效成员保留历史**：成员离开后，历史用量仍保留在原来的用户和部门下。「按用户」中用标签区分「已移出」（已退出本组织，账号仍在，可重新邀请）和「已删除」（账号已被平台删除）。已删除的 API Key 同样保留用量，并标记「已删除」。

## 自定义统计与导出 CSV

在「自定义统计」中选择「分组」（模型、意图、API Key、服务商、客户端、时间；当前账号管理员还有部门、用户），可选一个「细分（下钻）」维度，再选「排序依据」，需要时打开「筛选条件」和「显示图表」，点 **查询** 得到明细表和合计行。

- **组合限制**：不能同时用 API Key、用户、部门中的两个做分组和细分；意图只能与模型、API Key、用户、部门组合；按时间分组时不能细分。
- **细分行属于父分组**：例如按模型分组、按服务商细分时，细分行是这个模型在各服务商上的用量，与模型级的合计相比较时注意范围。
- **导出 CSV**：查询出结果后点 **导出 CSV**，导出当前表格的分组行和细分行。用量视角导出请求数、Token 各项、缓存命中率和成功率；费用视角导出请求数、金额和费用占比。

## 与日志、消费明细的区别

| | 用量分析 | 日志 | 消费明细 |
| --- | --- | --- | --- |
| 范围 | 当前工作空间的汇总 | 当前工作空间的逐条请求 | 整个组织的逐条扣费 |
| 包含哪些请求 | Token 只算成功请求；请求数不含被网关直接拒绝的请求 | 包括失败和被网关拒绝的请求 | 已结算、扣过 Credits 的请求 |
| 金额 | 人民币：平台按实付，BYOK 按服务商成本 | 每条请求的费用 | Credits |
| 谁能看 | 所有成员，普通成员只看自己的 Key | 所有成员，普通成员只看自己的 Key | 仅当前账号管理员 |

（截图：「消费明细」按 Credits 逐条记录实际扣费，可与用量分析的平台 Token 费用对照。）

## 常见问题

### 用量分析的费用和消费明细对不上，为什么？

**答：** 先对齐范围：用量分析只统计当前工作空间，消费明细覆盖整个组织；消费明细只包含已结算的请求，最近几分钟的调用可能还没进入。其次，用量分析的「BYOK Token 费用」「BYOK 订阅费用」是服务商成本，不从 Credits 扣除，消费明细里没有对应金额。只比较「平台 Token 费用」与消费明细换算后的金额。

### 为什么看不到「按部门」和「按用户」？

**答：** 这两个标签只对团队版、企业版的当前账号管理员显示。普通成员和个人版不显示，普通成员在其他标签中看到的也只是自己创建的 Key 的数据。

### 日志里有失败请求，成功率却没有下降？

**答：** 被网关直接拒绝的请求（例如 Key 无效、余额不足、限流、安全围栏拦截）不计入请求数和成功率，只在日志中可见。排查这类请求，请按日志中的报错原文处理，见[401 / 403](https://platform.lyrouter.com/ai_gateway/docs/auth-errors)和[429：限流与配额](https://platform.lyrouter.com/ai_gateway/docs/rate-errors)。