# 分析计费用量与费用

查询计费用量记录和汇总，按时间及业务维度分析费用，并查看 AI 服务用量。本页关注计费结果，不用于查询逐条模型请求日志。

## 前提条件

准备计费账户所属用户的有效[个人访问令牌](../../../../guides/billing/credentials.md)。先按[查询账户与计费设置](accounts.md)取得目标账户 ID。有关服务地址和认证方式，请参阅[服务地址与认证](../../../../reference/api/genesis/index.md#服务地址与认证)。

## 调用顺序

1. 确定要分析的时间范围和筛选条件，查询计费用量汇总，查看用量和费用。
2. 需要定位费用变化时，查询费用趋势，选择时间粒度和分组维度。
3. 需要核对具体记录时，使用对应筛选条件查询计费用量记录；保留已有记录的入账账期，供后续查询账单用量明细。
4. 需要按服务槽位或计费场景查看 AI 服务消耗时，单独查询 AI 服务用量。

## API 操作

| 要完成的事 | API 操作 | 何时使用或确认什么 |
| --- | --- | --- |
| 汇总用量和费用 | [查询计费用量汇总](../../../../reference/api/genesis/billing/usage/summary.md) | 按时间粒度查看聚合结果。 |
| 分析费用变化 | [查询费用趋势](../../../../reference/api/genesis/billing/usage/cost-trends.md) | 按时间和选定维度比较费用。 |
| 核对计费记录 | [查询计费用量记录](../../../../reference/api/genesis/billing/usage/records.md) | 查看记录状态、费用和入账账期。 |
| 查看 AI 服务消耗 | [查询 AI 服务用量](../../../../reference/api/genesis/billing/usage/ai-service.md) | 按服务槽位、计费场景等条件筛选。 |

## 结果确认

比较结果前，确认账户、时间范围、状态筛选和分组口径一致。需要核对具体费用时，使用[查询计费用量记录](../../../../reference/api/genesis/billing/usage/records.md)检查对应明细，并按该动作页的下一页标记读取后续记录。

## 限制和注意事项

计费用量汇总和费用趋势在未指定状态时不只包含已扣费记录。Credit 费用与支付币种金额不是同一单位；处理金额时保留十进制精度。AI 服务用量与普通计费记录使用不同的响应分页标记，不能共用同一套取值规则。

## 下一步

- [查询月账单与用量明细](bills.md)
