# 分析调用用量

查看当前用户的调用次数、Token 用量和费用，并按时间或模型、凭据等维度分析消耗。本页处理调用统计，不处理账户余额和月账单。

## 前提条件

准备个人访问令牌，并确定要分析的时间范围和调用范围。有关认证和查询范围，请参阅[使用与监测](../../../../reference/api/genesis/management/index.md)。

## 调用顺序

1. 查询调用用量汇总，确认所选范围内的调用次数、Token 用量、费用和成功率。
2. 需要观察变化时，使用相同筛选条件查询调用用量趋势，并检查实际返回的统计时间范围。
3. 需要定位消耗来源时，按模型或调用凭据查询分组用量。读取后续分页时保持筛选条件不变。
4. 需要检查具体调用时，转到[查询与排查请求日志](request-logs.md)，使用相同时间和调用范围缩小日志列表。

## API 操作

| 要完成的事 | API 操作 | 何时使用或确认什么 |
| --- | --- | --- |
| 查看整体用量 | [查询调用用量汇总](../../../../reference/api/genesis/management/usage/get-summary.md) | 获取所选范围内的调用次数、Token 用量、费用和成功率。 |
| 查看随时间的变化 | [查询调用用量趋势](../../../../reference/api/genesis/management/usage/get-trend.md) | 按小时或天查看调用统计。 |
| 定位消耗来源 | [查询分组用量](../../../../reference/api/genesis/management/usage/get-grouped-usage.md) | 按用户、模型或调用凭据查看分组结果。 |

## 结果确认

对比汇总、趋势和分组结果前，确认筛选条件及实际统计范围一致，并读取完整的分组分页。趋势接口可能缩短时间范围，不能直接将缩短后的趋势与原范围汇总比较。

## 限制和注意事项

- 查询限定为当前用户有权访问的调用；按用户分组不会扩大数据范围。
- 趋势只返回有数据的时间桶，不自动补齐空桶。
- 按调用凭据分组包含个人访问令牌、服务账号密钥和 TaaS 本地密钥，不等同于本地密钥列表。

## 下一步

- [查询与排查请求日志](request-logs.md)
- [账户与计费](../billing/index.md)