本文为管理员使用日志操作指引。
一、前置说明
- 适用场景：管理员登录 AI 平台，完成使用日志的查询与操作；
- 权限要求：操作账号必须拥有平台管理员权限。
二、操作步骤
进入菜单
登录AI 平台，在左侧菜单栏展开【仪表盘】，点击下方【使用日志】，进入页面。
日志类型
- 充值：用户主动充值额度、后台赠送额度入账记录，账户余额增加。
- 消费：调用 AI 模型接口产生 token 扣费，正常业务消耗流水（核心对账账单）。
- 管理：后台管理员人工操作：调整用户额度、启停令牌、权限变更等，不会产生模型计费。
- 系统：平台自动化执行操作，例如：过期额度回收、系统自动调额。
- 错误：上游服务商接口报错、无法正常返回结果。
- 退款：失败请求回退额度，返还被扣资金。
- 转账：账户之间额度划拨（子账号互转、分销商额度调拨）。
充值日志
用户主动充值额度、后台赠送额度入账记录，账户余额增加。例如：”通过兑换码充值 ¥100.000001 额度，兑换码ID” 如下图：
消费日志
- 字段说明：
| 列表字段 | 含义说明 |
|---|---|
| 时间 | API 请求 / 操作发生的精确时间戳；区分模型调用消费记录、额度变更管理记录两类数据 |
| 提供商 | 底层大模型渠道名称（对接的模型上游服务商，如 DeepSeek、OpenAI 等渠道标识） |
| 用户 | 发起调用的平台账号（体验账号 / 正式企业账号 / 分销商子账号） |
| 令牌 | 用户调用接口使用的 API Key(令牌)，多令牌场景可区分不同调用密钥 |
| 分组 | 提供商渠道分组，用于按线路 / 集群隔离流量、单独配置折扣与限流 |
| 类型 | 两条枚举：• 消费：正常发起 LLM 模型对话推理，产生 token 扣费• 管理：后台人工操作（额度调整、密钥启停等，不产生模型计费） |
| 模型 | 当前调用使用的具体模型名称（deepseek-v3.2、gpt-4o 等） |
| 用时 / 首字 | ・流式接口：首字耗时（TTFT，从发请求到返回第一个 token 时长）・非流式接口：完整请求总耗时单位：秒；0s代表请求未正常返回 / 中断 |
| 输入 | 输入 Token 数量（用户提问 prompt 消耗 token）；完整计费一般还要结合输出 token右侧悬浮提示：展示当前模型单价、生效企业折扣系数 |
| 详情 | 可展开查看完整请求信息：RequestID、输入输出完整内容、扣费明细、错误信息等 |
| 详情-提供商信息 | 当前调用流量归属的上游模型渠道（ID + 渠道名称） |
| 详情-Request ID | 单次 API 请求全局唯一编号；用于排查日志、对账、反馈异常调用，一条请求对应唯一一个 ID |
| 详情-日志详情 | 当前这条调用生效的基准定价与折扣配置：输入单价、输出单价、企业折扣倍率 |
| 详情-请求并计费模型 | 用户客户端接口传入请求的模型名称（对外展示模型名） |
| 详情-实际模型 | 后端真实转发给上游提供商使用的模型标识（内部路由别名，例如maic/deepseek-v3.2为路由前缀 + 模型名） |
- 筛选条件分项说明
| 筛选控件 | 功能说明 | 使用场景 |
|---|---|---|
| 令牌名称 | 根据用户调用接口使用的 API Key（令牌）模糊检索，支持输入令牌备注名称 / 令牌字符串 | 排查某个客户单独一条密钥下所有调用流量 |
| 模型名称（下拉选择） 筛选用户请求传入的目标模型（对外展示模型标识） | 单独统计 deepseek-v3.2、gpt-4o 等某一类模型用量 | |
| 分组（下拉选择） | 提供商渠道分组，对应上游线路集群配置 | 区分不同线路流量，用于线路负载、分渠道对账 |
| Request ID | 单次请求唯一编号，精确查询一条独立请求日志 | 故障排查首选，输入 ID 直达单条调用详情 |
| 用户（下拉选择） | 筛选发起调用的平台账号（体验账号 / 企业账号 / 分销商子账号） | 查看单个客户全部调用流水 |
| 类型下拉（当前显示：全部） | 可选择：消费 / 管理 / 全部 ・消费：AI 模型推理对话，产生扣费・管理：后台人工操作（额度修改、密钥启停，不计费） | 只想要账单流水就勾选【消费】 |
| 时间区间选择器 | 指定日志查询起止时间，默认当日 00:00~23:59 | 跨天对账、按月统计消耗额度 |
| 输出为空 □ 复选框 | 勾选后，仅筛选 AI 没有返回任何内容的异常请求（流式中断、报错截断、服务无响应） | 批量排查异常失败调用 |
日志详情
计费的过程
点击日志记录时间左侧的折叠箭头，即可展开查看本条调用完整计费详情。
计费过程简要说明
整体公式：(各项有效费用相加) × 企业折扣 = 总金额
「缓存读取」和「缓存写入、输出」互斥，不会同时计费
输入：用户提问消耗 token 费用（每次请求必计）
缓存读取：重复提问命中缓存，直接调取历史回答，收取读取费用；不再产生输出、缓存写入费用
输出：AI 实时生成回复的 token 费用
缓存写入：首次新请求，生成回答后存入缓存，和输出同步计费
企业折扣：所有费用求和后统一乘以折扣系数
总金额：最终实际扣费金额
管理日志
后台管理员人工操作：调整用户额度、启停令牌、权限变更等，不会产生模型计费。
错误日志
上游模型（上游服务商）
指平台对接的第三方大模型服务商（如 DeepSeek、OpenAI 等模型渠道），是真正承载 AI 推理运算的后端服务。
我们平台收到用户接口请求后，会转发任务至上游服务商，由上游完成内容生成并返回结果。「上游服务商接口报错、无法正常返回结果」完整释义
当平台把用户的对话请求转发给上游模型服务商时：
- 上游服务器返回异常响应（5xx 错误、限流过载、鉴权失败、通道故障、服务停机等）
- 上游未能正常完成 AI 推理，无法产出完整回答内容返回给用户
退款日志
主动受理用户退款，扣减账户余额。
转账日志
作者：admin 创建时间：2026-07-13 14:21
最后编辑：admin 更新时间：2026-07-21 14:21
最后编辑：admin 更新时间：2026-07-21 14:21
