用户指南
使用日志
查看每次调用模型的用量和扣费,以及充值、退款等额度变动记录,可按条件筛选和导出,并在详情中核对计费明细。
- 从侧边栏「常规」→「使用日志」进入。
- 查看每次调用模型的用量和扣费,以及充值、退款等额度变动记录。
- 调用模型会按价格扣账户里的额度(钱包余额或订阅额度),扣费明细在这里查看。
使用日志概览
- 使用日志-列表

列表中可按时间范围、模型、分组和类型等条件筛选日志,查看用量统计和每条记录的扣费明细:
提示
找不到某次调用的记录或费用与预期不符时,查看常见问题
字段说明:
| 字段 | 定义 | 填写要求和限制 | 备注 |
|---|---|---|---|
| 时间 | 记录产生的时间和日志类型。 | 由系统自动记录,不可修改。该列不可隐藏。 | 上方显示时间,精确到秒;下方以彩色文字显示日志类型,各类型的含义见日志类型。「错误」记录整行以浅红色显示,「退款」记录整行以浅蓝色显示。 |
| 渠道(仅管理员可见) | 处理该请求的渠道。 | 仅在「全部」视图中显示。仅「消耗」「错误」「退款」记录有内容。 | 显示「#渠道 ID」和渠道名称,点击 ID 可复制。发生重试时显示分叉图标,点击可查看「重试链路」;命中会话规则时 ID 右上角显示琥珀色 ✦,鼠标悬停可查看规则名和分组,点击可打开「渠道亲和性」窗口。 |
| 用户(仅管理员可见) | 发起请求的用户。 | 仅在「全部」视图中显示。 | 点击用户名可打开「用户信息」窗口,查看该用户的余额、已用额度、请求次数和分组等信息。 |
| 令牌 | 调用时使用的 API 密钥的名称。 | 仅「消耗」「错误」「退款」记录有内容。 | 下方显示调用使用的分组;分组倍率不为 1 或有专属倍率时,同时显示倍率,如「1.5x」。点击名称可复制。截图中已开启隐藏,名称和分组显示为圆点,见页面按钮与筛选中的「隐藏 / 显示」。 |
| 模型 | 调用的模型。 | 仅「消耗」「错误」「退款」记录有内容。 | 点击模型名称可复制。模型被站点映射到其他模型时,名称右侧显示路由图标,点击可查看「请求模型」和「实际模型」;上游返回的模型名与请求不一致时,显示琥珀色「响应模型:…」,点击可查看各模型名。 |
| 流 | 请求是否为流式输出,以及输出速度。 | 仅「消耗」「错误」记录有内容。 | 显示「流」或「非流」,异步任务的提交记录显示「同步」或「异步」;下方显示每秒输出的 Token 数,如「44 t/s」。流式输出未正常结束时显示红色感叹号,鼠标悬停可查看原因。 |
| Token | 本次调用的输入和输出 Token 数。 | 仅「消耗」「错误」「退款」记录有内容。 | 格式为「输入 / 输出」,均为 0 时显示「-」;使用了缓存时,下方显示「缓存↓」读取数和「↑」写入数。 |
| 费用 | 本条记录扣除或退回的额度。 | 仅「消耗」「错误」「退款」记录有内容,「错误」记录不扣费。 | 由订阅额度支付时,金额前显示皇冠图标,鼠标悬停显示「订阅」;账户有可用订阅时(管理员在「全部」视图下为站点有已启用的订阅套餐时),由钱包余额支付的记录显示钱包图标,悬停显示「钱包」。含工具调用附加费时,右侧显示扳手图标,悬停显示「包含工具调用附加费」。 |
| 耗时 | 请求的响应耗时。 | 仅「消耗」「错误」记录有内容。 | 流式请求显示「首字」(首个输出到达的时间)和「耗时」,非流式请求仅显示「耗时」;数字以绿、黄、红三色表示由快到慢。 |
| 详情 | 本条记录的摘要。 | 由系统自动生成。 | 如计费方式和单价、充值说明或错误信息,内容较多时末尾显示「+N」。点击打开「日志详情」窗口,见查看日志详情。 |
筛选日志并查看统计
操作流程:
- 点击「时间范围」,选择「今天」「7 天」等快捷范围;或填写「起始时间」「结束时间」后点击「确认」。
- 按需填写「模型名称」「分组」,在类型下拉框中选择日志类型。
- 按令牌名称、请求 ID 等查找时,点击「展开」,填写第二行的筛选项。
- 点击「搜索」,或在任一输入框中按回车键。
- 在筛选区左下角查看「用量」「RPM」「TPM」。
- 需要清除筛选条件时,点击「重置」。
提示
- 默认仅显示今天 00:00:00 至当前时间后 1 小时内的记录,查看更早的记录请先调整时间范围。
- 修改筛选条件后需点击「搜索」才会生效。页面不会自动刷新,新产生的记录需再次点击「搜索」后显示。
- 在手机上,除时间范围外的筛选项收在「筛选」中;选好时间范围后列表立即刷新。
筛选项说明:
筛选区分两行,第二行默认收起,点击「展开」后显示。下表按筛选区中的顺序排列。
| 筛选项 | 所属区域 | 定义 | 填写要求和限制 | 默认值 |
|---|---|---|---|---|
| 时间范围 | 第一行 | 按记录产生的时间筛选,起止时间均包含在内。 | 快捷范围:「今天」「7 天」(含今天)、「本周」(周日至周六)、「30 天」(含今天)、「本月」,点击后直接填入;手动填写时精确到秒,填好后点击「确认」。普通用户一次查询的时间跨度有上限(默认 365 天),超出时提示「时间跨度不能超过 … 天」。 | 今天 00:00:00 至当前时间后 1 小时 |
| 模型名称 | 第一行 | 按调用的模型筛选。 | 选填。默认按完整名称匹配;需模糊查找时,在关键词前后添加 %,如 %gpt%。最多使用 2 个 %,不可连续使用,% 以外至少输入 2 个字符。 | 空 |
| 分组 | 第一行 | 按调用时使用的分组筛选。 | 选填。可从下拉列表中选择,也可直接输入,按完整名称匹配。 | 空 |
| 类型 | 第一行 | 按日志类型筛选。 | 单选:「所有类型」「充值」「消耗」「管理」「系统」「错误」「退款」「登录」。「管理」「登录」带「已弃用」标记,仅用于查询历史日志。各类型的含义见日志类型。 | 「所有类型」 |
| 令牌名称 | 第二行 | 按调用时使用的 API 密钥的名称筛选。 | 选填,按完整名称匹配,不支持模糊查找。 | 空 |
| 用户名(仅管理员可见) | 第二行 | 按发起请求的用户筛选。 | 仅在「全部」视图中显示。默认按完整用户名匹配,模糊查找规则与「模型名称」相同。 | 空 |
| 渠道 ID(仅管理员可见) | 第二行 | 按处理请求的渠道筛选。 | 仅在「全部」视图中显示,填写渠道 ID 数字。 | 空 |
| 请求 ID | 第二行 | 按 New API 为每次请求生成的编号查找。 | 选填,按完整 ID 匹配,可从「日志详情」中复制。 | 空 |
| 上游请求 ID | 第二行 | 按上游服务返回的请求编号查找。 | 选填,按完整 ID 匹配。 | 空 |
统计项说明:
统计值位于筛选区左下角,随「搜索」一起刷新。
| 统计项 | 定义 | 统计范围 |
|---|---|---|
| 用量 | 「消耗」记录的费用合计。 | 所选时间范围内、符合「模型名称」「分组」「令牌名称」(管理员另含「用户名」「渠道 ID」)的「消耗」记录。不受「类型」「请求 ID」「上游请求 ID」影响,也不扣除「退款」。 |
| RPM | 每分钟请求数,即最近 60 秒内的「消耗」记录条数。 | 始终统计最近 60 秒,与所选时间范围无关;受「模型名称」「分组」「令牌名称」等筛选影响。 |
| TPM | 每分钟 Token 数,即最近 60 秒内「消耗」记录的输入和输出 Token 总数。 | 同 RPM。 |
查看日志详情
操作流程:
- 点击记录所在行「详情」列的摘要文字,打开「日志详情」窗口。
- 按区域查看该记录的请求信息、Token 用量和计费明细。
- 需要复制日志内容时,点击「内容」右上角的复制按钮。
提示
- 窗口仅显示该记录实际保存的信息,不同类型、不同请求的记录显示的区域不同。
- 核对计费时,查看「Token 明细」和「计费详情」。
详情窗口说明:
下表按窗口中从上到下的顺序排列。
| 区域 | 内容 | 显示条件 |
|---|---|---|
| 请求 ID、上游请求 ID | New API 生成的请求编号,以及上游返回的请求编号。 | 记录中有该编号时显示。 |
| 渠道、重试链路(仅管理员可见) | 处理请求的渠道;发生重试时依次列出尝试过的渠道。 | 「全部」视图。 |
| 令牌、分组 | 调用使用的 API 密钥名称和分组。 | 记录中有该信息时显示。 |
| IP 地址 | 发起请求的 IP 地址。 | 账户开启「记录 IP 地址」后产生的「消耗」「错误」记录;「全部」视图下的在线充值记录(仅管理员可见)。 |
| 响应时间 | 请求耗时;流式请求在括号中显示首字时间「FRT」。 | 「消耗」「错误」记录。 |
| 请求转换(仅管理员可见) | 请求路径,以及请求格式的转换过程,未转换时显示「原生格式」。 | 「全部」视图。 |
| 请求策略决策(仅管理员可见) | 选择渠道、重试或停止的过程,见请求策略决策。 | 「全部」视图,且记录中有决策记录。 |
| 额度已钳制(仅管理员可见) | 额度计算结果超出可记录范围而被系统截断时的类型、原始值和截断后的值。 | 「全部」视图,且发生过额度钳制;该行在列表中整行以浅琥珀色显示。 |
| 拒绝原因(仅管理员可见) | 请求被拒绝的原因。 | 「全部」视图,且记录中有拒绝原因。 |
| 违规扣费 | 违规代码、违规标记和扣费金额。 | 因违规被扣费的记录。 |
| 退款详情 | 退款对应的任务 ID 和原因。 | 「退款」记录。 |
| 任务插件(仅管理员可见) | 处理该任务的插件名称、键、版本和作者。 | 「全部」视图,且记录由任务插件产生。 |
| Root 诊断(仅 Root 可见) | API 版本、插件运行代次、上游任务 ID 和节点名称。 | Root 在「全部」视图下,且记录中有相关信息。 |
| 充值审计信息(仅管理员可见) | 订单和支付回调的支付方式、回调方 IP、服务器 IP、节点名称和系统版本。 | 「全部」视图下的「充值」记录。 |
| 额度调整详情 | 管理员调整额度的方式、数额和调整前后的额度。 | 管理员调整额度产生的「充值」记录。 |
| 操作管理员、操作审计信息(仅管理员可见) | 执行操作的管理员和操作明细。 | 「全部」视图下的「管理」历史记录。 |
| 登录信息 | 登录方式、IP 地址和客户端。 | 「登录」历史记录。 |
| 语音 Token | 语音和文字的输入、输出 Token 数。 | 实时语音或音频请求。 |
| 推理强度 | 请求设置的推理强度。 | 请求中设置了推理强度时。 |
| 系统提示词 | 显示「已覆盖」,表示站点替换了请求中的系统提示词。 | 站点覆盖了系统提示词时。 |
| 响应模型或模型映射 | 「请求模型」「上游请求模型」「响应模型」,或「请求模型」「实际模型」,每项均可复制。 | 上游返回了模型名,或模型被站点映射时。 |
| Token 明细 | 输入、输出、缓存读取、缓存写入、图像等 Token 数;按档位计费时另有「计价 Token 明细」。 | 「消耗」「错误」「退款」记录中有 Token 数时。 |
| 计费详情 | 计费模式,模型价格或输入、输出单价(每百万 Token),分组倍率或专属倍率,缓存、音频、图片等附加价格,网页搜索等工具的次数和价格,命中阶梯,总费用;其中「计费路径」仅管理员可见。 | 「消耗」记录(违规扣费除外)。 |
| 动态计费 | 计费图片数量、分档价格表(命中的档位标注「已命中」)、适用条件和条件乘数。 | 按动态表达式计费的「消耗」记录。 |
| 计费路径(仅管理员可见) | 「本地计费」或「上游返回」。 | 「全部」视图下除「消耗」「退款」外的记录。 |
| 流状态 | 流式输出的状态、结束原因、软错误数和错误明细。 | 流式输出未正常结束时。 |
| 订阅计费 | 套餐、实例、预扣费、结算差额、最终消耗和订阅剩余额度。 | 由订阅额度支付的记录。 |
| 参数覆盖 (…) | 站点对请求参数做的修改,每条显示动作和内容。 | 站点对该请求做过参数覆盖时。 |
| 内容 | 日志正文,「错误」记录为错误信息;右上角可复制。 | 记录中有内容时。 |
请求策略决策
「日志详情」中的「请求策略决策」区域(仅管理员可见)按步骤列出该请求选择渠道、重试或停止的过程,仅在页面右上角选择「全部」时显示,选择「仅自己」后不显示。
- 成功的请求:决策记录随「消耗」记录写入,至少包含「选择渠道」「请求已完成」两步。管理员关闭「记录配额使用量」后不再写入。
- 失败的尝试:每次失败的尝试各写一条「错误」记录,带有截至该次尝试的决策记录。站点未开启错误日志记录时不写入这类记录,此时看不到失败尝试的决策记录。
步骤的显示方式:
- 第一行:决策内容;涉及渠道时后接「#渠道 ID」,失败的步骤后接 HTTP 状态码;停止重试的步骤以琥珀色显示。
- 第二行:「尝试 N」、从请求开始累计的耗时(毫秒)、分组、命中的规则名和 HTTP 状态码,无相应信息的项不显示。
- 第三行:「来源:」及该决定的依据;该次失败对渠道健康有处理时,在来源后显示。
决策内容说明:
| 决策内容 | 含义 |
|---|---|
| 选择渠道 | 本次尝试选中的渠道。 |
| 命中会话规则 | 请求命中了一条会话保持规则,规则名显示在第二行。 |
| 上游请求失败 | 本次尝试在上游或网络连接环节失败。 |
| 请求在本地被拒绝 | 请求在发往上游前被本地检查拒绝。 |
| 渠道错误 | 判定为渠道本身出错。 |
| 状态码命中重试规则 | 失败的状态码在重试规则范围内,继续重试。 |
| 状态码未命中重试规则 | 失败的状态码不在重试规则范围内,不再重试。 |
| 无法识别的状态码 | 上游返回的状态码无法识别。 |
| 整次尝试次数已耗尽 | 已达到最多尝试次数,不再重试。 |
| 系统禁止重试的情况 | 属于系统规定不重试的情况,不再重试。 |
| 固定渠道约束 | 请求被固定到某个渠道,不切换渠道。 |
| 会话保持设置阻止切换渠道 | 会话保持要求使用原渠道,不切换渠道。 |
| 任务已接受,不能重复提交 | 异步任务已被上游接受,不再重试。 |
| 任务失败 | 异步任务在提交时失败。 |
| 流式输出未成功完成 | 流式输出未正常结束。 |
| 请求已完成 | 请求成功结束。 |
来源与健康处理:
- 来源:「全局默认」「全局与渠道设置」「渠道」「会话规则」表示依据站点或渠道的重试、会话设置;「系统约束」「固定渠道约束」表示依据系统规则;「渠道选择」「上游响应」「上游连接」「本地检查」表示依据该次尝试的实际情况。
- 健康处理:「不变」表示渠道状态未改变;「已请求停用渠道」「已请求停用当前密钥」表示该次失败触发了停用请求。
导出日志
操作流程:
- 按需设置页面上的筛选条件,点击「搜索」。
- 点击筛选区右下角的「导出」,打开「导出日志」窗口。
- 在窗口中设置要导出的时间范围。
- 点击窗口中的「导出」,等待浏览器下载文件。
提示
- 管理员关闭用户导出后,普通用户的页面上不显示「导出」;管理员始终可导出。
- 同一账户同一时间仅可进行一个导出,导出过程中关闭窗口会中止导出。
- 「隐藏」不影响导出,文件中的名称均为原文。
配置项说明:
| 配置项 | 定义 | 填写要求和限制 | 默认值 |
|---|---|---|---|
| 时间范围 | 要导出的记录的时间范围。 | 必填,需同时设置起止时间。结束时间早于起始时间时提示「结束时间必须晚于开始时间」;跨度超过上限(默认 365 天)时提示「时间跨度不能超过 … 天」,此时「导出」不可点击。页面上的模型名称、分组、类型、令牌名称、请求 ID 等其他筛选条件同样生效。 | 页面当前生效的时间范围 |
导出文件说明:
- 文件为 CSV 格式,文件名为「usage-logs-起始日期-结束日期.csv」,如
usage-logs-20261101-20261108.csv,可用表格软件直接打开。 - 包含「时间」「类型」「令牌」「分组」「模型」「流」「输入 Token」「输出 Token」「缓存读取」「缓存写入」「费用」「耗时」「IP」「请求 ID」「详情」列。在「全部」视图下导出时,另含「用户」「渠道」列(仅管理员可见),并包含所有用户的记录。
- 记录按时间从新到旧排列,不限条数。
操作项说明
页面按钮与筛选
| 操作 | 位置 | 说明 |
|---|---|---|
| 全部 / 仅自己(仅管理员可见) | 页面右上角 | 默认为「全部」,显示所有用户的记录,以及「渠道」「用户」列、「用户名」「渠道 ID」筛选和详情窗口中的管理员区域。「仅自己」仅显示本账户的记录,页面内容与普通用户相同。 |
| 时间范围、模型名称、分组、类型 | 筛选区第一行 | 见筛选日志并查看统计。 |
| 展开 / 收起 | 筛选区第一行右侧 | 显示或隐藏第二行筛选项,默认收起;第二行已填写的筛选项数量显示在按钮上。截图中已展开。 |
| 令牌名称、请求 ID、上游请求 ID | 筛选区第二行 | 见筛选日志并查看统计。 |
| 用户名、渠道 ID(仅管理员可见) | 筛选区第二行 | 见筛选日志并查看统计。 |
| 用量、RPM、TPM | 筛选区左下角 | 统计值,见筛选日志并查看统计。 |
| 隐藏 / 显示 | 筛选区右下角的眼睛图标 | 隐藏后,令牌名称、分组、用户名、渠道名称、「用量」金额和对应筛选框中的内容以圆点显示,适合截图或共享屏幕时使用;费用、模型、详情窗口和导出文件不受影响。刷新页面后恢复显示。 |
| 重置 | 筛选区右下角 | 设置了时间范围以外的筛选条件时可点击,清除所有筛选条件并恢复默认时间范围。 |
| 搜索 | 筛选区右下角 | 按当前条件刷新列表和统计值,并回到第 1 页。 |
| 导出 | 筛选区右下角 | 打开「导出日志」窗口,见导出日志。 |
| 查看 | 筛选区右下角 | 在「切换列」中选择要显示的列,「时间」列不可隐藏;设置保存在当前浏览器中。 |
| 每页行数、翻页 | 列表底部 | 「每页行数」默认为 100(手机上为 20),可选 10、20、30、40、50、100;「总计」为符合条件的记录数。 |
行操作
| 操作 | 位置 | 说明 |
|---|---|---|
| 查看日志详情 | 「详情」列的摘要文字 | 打开「日志详情」窗口,见查看日志详情。 |
| 复制日志内容 | 「日志详情」窗口「内容」右上角的复制按钮 | 复制日志正文,见查看日志详情。 |
| 复制模型名称 | 「模型」列的模型名称 | 点击即复制;名称旁有路由图标或「响应模型」提示时,点击打开浮层,可分别复制各模型名称。 |
| 复制令牌名称 | 「令牌」列的名称 | 点击即复制。 |
| 复制渠道 ID(仅管理员可见) | 「渠道」列的「#渠道 ID」 | 点击即复制。 |
| 查看重试链路(仅管理员可见) | 「渠道」列的分叉图标 | 显示该请求依次尝试过的渠道。 |
| 查看渠道亲和性(仅管理员可见) | 「渠道」列右上角的 ✦ | 打开「渠道亲和性」窗口,查看会话规则的缓存统计。 |
| 查看用户信息(仅管理员可见) | 「用户」列的用户名 | 打开「用户信息」窗口。 |
状态项说明
日志类型
「时间」列下方和类型筛选中的日志类型:
| 类型 | 含义 | 备注 |
|---|---|---|
| 充值 | 账户额度增加或被管理员调整,包括兑换码充值、在线充值成功、购买订阅(含用余额购买),以及管理员增加、减少或覆盖账户额度。 | 青色。管理员调整额度的记录,详情中显示「额度调整详情」。 |
| 消耗 | 调用模型成功并扣费;提交视频、音乐等异步任务时的扣费也记为「消耗」。 | 绿色。「用量」统计仅汇总该类型。 |
| 管理 | 管理员操作的历史记录。 | 橙色。筛选中带「已弃用」标记,仅用于查询历史日志;新的管理操作记录见审计日志。 |
| 系统 | 系统发放的额度,包括新用户注册奖励、邀请奖励和每日签到奖励。 | 紫色。 |
| 错误 | 调用模型失败的请求。 | 红色,整行以浅红色显示,不扣费。仅在站点开启错误日志记录后出现。 |
| 退款 | 异步任务失败或超时后退回的额度,以及任务按实际用量结算后退回的差额。 | 蓝色,整行以浅蓝色显示,「详情」列显示「异步任务退款」。详情中的「退款详情」显示任务 ID 和原因,见任务日志。 |
| 登录 | 登录的历史记录。 | 青绿色。筛选中带「已弃用」标记,仅用于查询历史日志;新的登录记录见审计日志。 |
常见问题
相关文档
这篇文档对您有帮助吗?
最后更新于