使用指南用户指南
用量与日志
使用日志字段详解、任务日志、用量统计与消费排查方法。
平台记录每一次调用的完整明细。搞清楚这一页，你就能自己回答「这笔钱是怎么花掉的」。
菜单位置：左侧 常规 → 使用日志 / 任务日志。
使用日志
每一行是一次 API 调用。核心字段：
| 字段 | 说明 |
|---|---|
| 时间 | 请求发生时间 |
| 令牌 | 使用的 API 密钥名称——定位是哪个业务在花钱最有用的字段 |
| 模型 | 实际调用的模型 |
| 分组 | 本次请求走的供应商线路 |
| 用量 | 输入 tokens / 输出 tokens，以及缓存读写量；按次计费的模型显示次数 |
| 消费 | 本次调用的实际扣费 |
| 耗时 | 请求总耗时；流式请求还会记录首字延迟 |
| 重试 | 是否发生过重试，以及重试了几次 |
| 请求 ID | 唯一标识。报障时请提供这个 ID，客服凭它能定位到具体那一次请求 |
| 类型 | 见下方日志类型 |
点击任意一行可以展开完整详情，包括提示词预览、错误信息全文、生成的图片 / 音频 / 视频预览等。
日志类型
顶部可以按类型筛选：
| 类型 | 含义 |
|---|---|
| 消费 | 正常的 API 调用扣费，日常看的就是这类 |
| 充值 | 余额入账记录（充值、兑换码） |
| 退款 | 调用失败后预扣额度的退回 |
| 错误 | 请求失败的记录，含失败原因 |
| 管理 | 管理员对账户的操作（如手动调额） |
| 系统 | 系统事件 |
看到退款类型不用担心，这是正常机制：请求开始时按预估量预扣，失败或实际用量更少时，差额会自动退回。
筛选与查找
支持按时间范围（24 小时 / 7 天 / 14 天 / 自定义）、密钥、模型、类型筛选。
排障时最快的路径是：先按时间范围缩小，再按类型选错误，然后点开具体那条看完整错误信息。
任务日志
绘图、视频生成等异步任务不走同步日志，在任务日志页查看。字段包括：
| 字段 | 说明 |
|---|---|
| 任务 ID | 任务唯一标识 |
| 提交时间 | 任务创建时间 |
| 进度 / 状态 | 排队中、执行中、成功、失败 |
| 提交结果 | 任务提交时上游的返回 |
| 失败原因 | 失败时的具体错误 |
异步任务的扣费在任务完成后结算；任务失败会退还预扣额度。
用量统计
除了逐条日志，还有几个汇总视图：
- 总览（常规 → 总览）：余额、近期消费、按日的调用量与消费趋势、模型分布。
- 数据看板（常规 → 数据看板）：按模型、按时间维度的细分用量分析。
- 单个密钥的累计消费：在 API 密钥列表里直接看。
消费排查
消费比预期高
按这个顺序查：
- 按密钥筛选日志 — 先确认是哪把密钥、哪个业务在消耗。异常集中在某一把密钥上，往往意味着该密钥被误用或泄露。
- 看模型 — 是不是用了单价更高的模型？模型价格见模型广场。
- 看输入 tokens — 长上下文、把整篇文档塞进 prompt、多轮对话累积历史，都会让输入量远超预期。这是超预算最常见的原因。
- 看重试次数 — 频繁重试意味着上游不稳定，也会放大消耗。
- 看缓存字段 — 命中缓存的部分单价更低，没命中就是全价。
调用失败
日志里的错误类型会记录具体原因。常见的额度不足、模型不可用、参数错误、无可用供应商等，排查步骤见常见问题排查。
对账
需要正式对账时不要逐页翻日志，用账单页的月度账单和每日对账功能，可以直接导出 CSV。见账单与对账。