New APINew API
使用指南部署安装API 参考AI 应用Skills插件帮助支持商务合作合规与使用政策
⚠️合规提示:本项目仅用于合法授权的 API 网关、内部管理和私有化部署场景。请遵守上游服务条款、平台规则、监管要求和内容安全要求。
用户指南

使用日志

查看每次调用模型的用量和扣费,以及充值、退款等额度变动记录,可按条件筛选和导出,并在详情中核对计费明细。

  • 从侧边栏「常规」→「使用日志」进入。
  • 查看每次调用模型的用量和扣费,以及充值、退款等额度变动记录。
  • 调用模型会按价格扣账户里的额度(钱包余额或订阅额度),扣费明细在这里查看。

提示

  • 页面标题显示为「通用日志」。
  • 普通用户仅可查看本账户的记录。管理员可在页面右上角切换「全部」「仅自己」(仅管理员可见),选择「仅自己」时,页面内容与普通用户相同。
  • 费用和用量的显示单位由站点决定。
  • 登录和账户安全操作的记录见审计日志;视频、音乐、绘图等异步任务的状态见任务日志。
  • 左侧边栏无「使用日志」页时:
    到「个人资料」页的「左侧边栏个人设置」区域中,开启「控制台区域」和「使用日志」并保存。

使用日志概览

  • 使用日志-列表

使用日志-列表页面

列表中可按时间范围、模型、分组和类型等条件筛选日志,查看用量统计和每条记录的扣费明细:

提示

找不到某次调用的记录或费用与预期不符时,查看常见问题

字段说明:

字段定义填写要求和限制备注
时间记录产生的时间和日志类型。由系统自动记录,不可修改。该列不可隐藏。上方显示时间,精确到秒;下方以彩色文字显示日志类型,各类型的含义见日志类型。「错误」记录整行以浅红色显示,「退款」记录整行以浅蓝色显示。
渠道(仅管理员可见)处理该请求的渠道。仅在「全部」视图中显示。仅「消耗」「错误」「退款」记录有内容。显示「#渠道 ID」和渠道名称,点击 ID 可复制。发生重试时显示分叉图标,点击可查看「重试链路」;命中会话规则时 ID 右上角显示琥珀色 ✦,鼠标悬停可查看规则名和分组,点击可打开「渠道亲和性」窗口。
用户(仅管理员可见)发起请求的用户。仅在「全部」视图中显示。点击用户名可打开「用户信息」窗口,查看该用户的余额、已用额度、请求次数和分组等信息。
令牌调用时使用的 API 密钥的名称。仅「消耗」「错误」「退款」记录有内容。下方显示调用使用的分组;分组倍率不为 1 或有专属倍率时,同时显示倍率,如「1.5x」。点击名称可复制。截图中已开启隐藏,名称和分组显示为圆点,见页面按钮与筛选中的「隐藏 / 显示」。
模型调用的模型。仅「消耗」「错误」「退款」记录有内容。点击模型名称可复制。模型被站点映射到其他模型时,名称右侧显示路由图标,点击可查看「请求模型」和「实际模型」;上游返回的模型名与请求不一致时,显示琥珀色「响应模型:…」,点击可查看各模型名。
流请求是否为流式输出,以及输出速度。仅「消耗」「错误」记录有内容。显示「流」或「非流」,异步任务的提交记录显示「同步」或「异步」;下方显示每秒输出的 Token 数,如「44 t/s」。流式输出未正常结束时显示红色感叹号,鼠标悬停可查看原因。
Token本次调用的输入和输出 Token 数。仅「消耗」「错误」「退款」记录有内容。格式为「输入 / 输出」,均为 0 时显示「-」;使用了缓存时,下方显示「缓存↓」读取数和「↑」写入数。
费用本条记录扣除或退回的额度。仅「消耗」「错误」「退款」记录有内容,「错误」记录不扣费。由订阅额度支付时,金额前显示皇冠图标,鼠标悬停显示「订阅」;账户有可用订阅时(管理员在「全部」视图下为站点有已启用的订阅套餐时),由钱包余额支付的记录显示钱包图标,悬停显示「钱包」。含工具调用附加费时,右侧显示扳手图标,悬停显示「包含工具调用附加费」。
耗时请求的响应耗时。仅「消耗」「错误」记录有内容。流式请求显示「首字」(首个输出到达的时间)和「耗时」,非流式请求仅显示「耗时」;数字以绿、黄、红三色表示由快到慢。
详情本条记录的摘要。由系统自动生成。如计费方式和单价、充值说明或错误信息,内容较多时末尾显示「+N」。点击打开「日志详情」窗口,见查看日志详情。

筛选日志并查看统计

操作流程:

  1. 点击「时间范围」,选择「今天」「7 天」等快捷范围;或填写「起始时间」「结束时间」后点击「确认」。
  2. 按需填写「模型名称」「分组」,在类型下拉框中选择日志类型。
  3. 按令牌名称、请求 ID 等查找时,点击「展开」,填写第二行的筛选项。
  4. 点击「搜索」,或在任一输入框中按回车键。
  5. 在筛选区左下角查看「用量」「RPM」「TPM」。
  6. 需要清除筛选条件时,点击「重置」。

提示

  • 默认仅显示今天 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。

查看日志详情

操作流程:

  1. 点击记录所在行「详情」列的摘要文字,打开「日志详情」窗口。
  2. 按区域查看该记录的请求信息、Token 用量和计费明细。
  3. 需要复制日志内容时,点击「内容」右上角的复制按钮。

提示

  • 窗口仅显示该记录实际保存的信息,不同类型、不同请求的记录显示的区域不同。
  • 核对计费时,查看「Token 明细」和「计费详情」。

详情窗口说明:

下表按窗口中从上到下的顺序排列。

区域内容显示条件
请求 ID、上游请求 IDNew API 生成的请求编号,以及上游返回的请求编号。记录中有该编号时显示。
渠道、重试链路(仅管理员可见)处理请求的渠道;发生重试时依次列出尝试过的渠道。「全部」视图。
令牌、分组调用使用的 API 密钥名称和分组。记录中有该信息时显示。
IP 地址发起请求的 IP 地址。账户开启「记录 IP 地址」后产生的「消耗」「错误」记录;「全部」视图下的在线充值记录(仅管理员可见)。
响应时间请求耗时;流式请求在括号中显示首字时间「FRT」。「消耗」「错误」记录。
请求转换(仅管理员可见)请求路径,以及请求格式的转换过程,未转换时显示「原生格式」。「全部」视图。
请求策略决策(仅管理员可见)选择渠道、重试或停止的过程,见请求策略决策。「全部」视图,且记录中有决策记录。
额度已钳制(仅管理员可见)额度计算结果超出可记录范围而被系统截断时的类型、原始值和截断后的值。「全部」视图,且发生过额度钳制;该行在列表中整行以浅琥珀色显示。
拒绝原因(仅管理员可见)请求被拒绝的原因。「全部」视图,且记录中有拒绝原因。
违规扣费违规代码、违规标记和扣费金额。因违规被扣费的记录。
退款详情退款对应的任务 ID 和原因。「退款」记录。
任务插件(仅管理员可见)处理该任务的插件名称、键、版本和作者。「全部」视图,且记录由任务插件产生。
Root 诊断(仅 Root 可见)API 版本、插件运行代次、上游任务 ID 和节点名称。Root 在「全部」视图下,且记录中有相关信息。
充值审计信息(仅管理员可见)订单和支付回调的支付方式、回调方 IP、服务器 IP、节点名称和系统版本。「全部」视图下的「充值」记录。
额度调整详情管理员调整额度的方式、数额和调整前后的额度。管理员调整额度产生的「充值」记录。
操作管理员、操作审计信息(仅管理员可见)执行操作的管理员和操作明细。「全部」视图下的「管理」历史记录。
登录信息登录方式、IP 地址和客户端。「登录」历史记录。
语音 Token语音和文字的输入、输出 Token 数。实时语音或音频请求。
推理强度请求设置的推理强度。请求中设置了推理强度时。
系统提示词显示「已覆盖」,表示站点替换了请求中的系统提示词。站点覆盖了系统提示词时。
响应模型或模型映射「请求模型」「上游请求模型」「响应模型」,或「请求模型」「实际模型」,每项均可复制。上游返回了模型名,或模型被站点映射时。
Token 明细输入、输出、缓存读取、缓存写入、图像等 Token 数;按档位计费时另有「计价 Token 明细」。「消耗」「错误」「退款」记录中有 Token 数时。
计费详情计费模式,模型价格或输入、输出单价(每百万 Token),分组倍率或专属倍率,缓存、音频、图片等附加价格,网页搜索等工具的次数和价格,命中阶梯,总费用;其中「计费路径」仅管理员可见。「消耗」记录(违规扣费除外)。
动态计费计费图片数量、分档价格表(命中的档位标注「已命中」)、适用条件和条件乘数。按动态表达式计费的「消耗」记录。
计费路径(仅管理员可见)「本地计费」或「上游返回」。「全部」视图下除「消耗」「退款」外的记录。
流状态流式输出的状态、结束原因、软错误数和错误明细。流式输出未正常结束时。
订阅计费套餐、实例、预扣费、结算差额、最终消耗和订阅剩余额度。由订阅额度支付的记录。
参数覆盖 (…)站点对请求参数做的修改,每条显示动作和内容。站点对该请求做过参数覆盖时。
内容日志正文,「错误」记录为错误信息;右上角可复制。记录中有内容时。

请求策略决策

「日志详情」中的「请求策略决策」区域(仅管理员可见)按步骤列出该请求选择渠道、重试或停止的过程,仅在页面右上角选择「全部」时显示,选择「仅自己」后不显示。

  • 成功的请求:决策记录随「消耗」记录写入,至少包含「选择渠道」「请求已完成」两步。管理员关闭「记录配额使用量」后不再写入。
  • 失败的尝试:每次失败的尝试各写一条「错误」记录,带有截至该次尝试的决策记录。站点未开启错误日志记录时不写入这类记录,此时看不到失败尝试的决策记录。

步骤的显示方式:

  1. 第一行:决策内容;涉及渠道时后接「#渠道 ID」,失败的步骤后接 HTTP 状态码;停止重试的步骤以琥珀色显示。
  2. 第二行:「尝试 N」、从请求开始累计的耗时(毫秒)、分组、命中的规则名和 HTTP 状态码,无相应信息的项不显示。
  3. 第三行:「来源:」及该决定的依据;该次失败对渠道健康有处理时,在来源后显示。

决策内容说明:

决策内容含义
选择渠道本次尝试选中的渠道。
命中会话规则请求命中了一条会话保持规则,规则名显示在第二行。
上游请求失败本次尝试在上游或网络连接环节失败。
请求在本地被拒绝请求在发往上游前被本地检查拒绝。
渠道错误判定为渠道本身出错。
状态码命中重试规则失败的状态码在重试规则范围内,继续重试。
状态码未命中重试规则失败的状态码不在重试规则范围内,不再重试。
无法识别的状态码上游返回的状态码无法识别。
整次尝试次数已耗尽已达到最多尝试次数,不再重试。
系统禁止重试的情况属于系统规定不重试的情况,不再重试。
固定渠道约束请求被固定到某个渠道,不切换渠道。
会话保持设置阻止切换渠道会话保持要求使用原渠道,不切换渠道。
任务已接受,不能重复提交异步任务已被上游接受,不再重试。
任务失败异步任务在提交时失败。
流式输出未成功完成流式输出未正常结束。
请求已完成请求成功结束。

来源与健康处理:

  • 来源:「全局默认」「全局与渠道设置」「渠道」「会话规则」表示依据站点或渠道的重试、会话设置;「系统约束」「固定渠道约束」表示依据系统规则;「渠道选择」「上游响应」「上游连接」「本地检查」表示依据该次尝试的实际情况。
  • 健康处理:「不变」表示渠道状态未改变;「已请求停用渠道」「已请求停用当前密钥」表示该次失败触发了停用请求。

导出日志

操作流程:

  1. 按需设置页面上的筛选条件,点击「搜索」。
  2. 点击筛选区右下角的「导出」,打开「导出日志」窗口。
  3. 在窗口中设置要导出的时间范围。
  4. 点击窗口中的「导出」,等待浏览器下载文件。

提示

  • 管理员关闭用户导出后,普通用户的页面上不显示「导出」;管理员始终可导出。
  • 同一账户同一时间仅可进行一个导出,导出过程中关闭窗口会中止导出。
  • 「隐藏」不影响导出,文件中的名称均为原文。

配置项说明:

配置项定义填写要求和限制默认值
时间范围要导出的记录的时间范围。必填,需同时设置起止时间。结束时间早于起始时间时提示「结束时间必须晚于开始时间」;跨度超过上限(默认 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 和原因,见任务日志。
登录登录的历史记录。青绿色。筛选中带「已弃用」标记,仅用于查询历史日志;新的登录记录见审计日志。

常见问题

相关文档

这篇文档对您有帮助吗?

最后更新于