ZeroCat 把请求明细、绘图记录和视频、音乐等异步任务分开保存。登录后可以从左侧导航进入「使用日志」或「任务日志」,只能看到你自己的记录。

使用日志

在左侧边栏点击「使用日志」,查看每次 API 请求和计费明细。

筛选记录

页面统计

  • Usage:符合当前筛选条件的消费额度合计。
  • RPM:最近 60 秒内的请求数。
  • TPM:最近 60 秒内的输入与输出 Token 总数。

列表与详情

列表显示时间和类型、令牌、模型、是否流式、Tokens、费用、耗时和详情。
  1. Tokens:输入 Token / 输出 Token;使用缓存时还可能显示缓存读取和写入数量。
  2. 费用:这条记录消耗或退回的额度。
  3. 耗时:响应耗时;流式请求还可能显示首字响应时间(FRT)和吞吐信息。
  4. 详情:点击记录打开详情,可能包含请求 ID、错误或退款原因、Token 明细、计费明细、缓存/音频/图片用量等。不是每条记录都有全部内容。
「安全与访问」→「隐私」中的「记录 IP 地址」设置,决定消费日志和错误日志是否保存请求 IP。并非每个失败的请求都会生成错误日志。

任务日志

「任务日志」下分为两类:
  • 绘图日志:Midjourney 绘图任务。
  • 任务日志:文生视频、图生视频、音频生成等异步任务。

绘图日志

点击「任务日志」→「绘图日志」,可以按日期范围和 Midjourney 任务 ID 筛选。
  1. 列表包含提交时间、状态、操作类型、任务 ID、耗时、提交结果、进度、图片、提示词和失败原因。点击图片可以预览,点击提示词或失败原因可以查看完整内容。
  2. 绘图状态包括:未启动、队列中、执行中、成功、失败、窗口等待。
  3. 状态由后台定时查询上游后更新,可能有延迟。提交超过约 1 小时仍未完成的任务会被标记为失败。

异步任务日志

点击「任务日志」→「任务日志」,可以按日期范围和任务 ID 筛选。 视频、音乐等异步接口不会在提交时立即返回结果。提交成功后会返回任务 ID,之后由后台查询上游并更新状态、进度和结果。
  • Suno 任务成功后,详情列提供音频预览。
  • 部分视频任务成功后会显示预览入口;也可以用 API 密钥请求 GET /v1/videos/{task_id}/content 获取视频内容。任务未完成或不属于当前账号时不会返回内容。
  • 失败的任务会在详情列显示失败原因。

任务状态

刚提交的任务状态可能有延迟,后台大约每 15 秒查询一次。

失败与退款

任务失败后,如果提交时预扣了额度,系统通常会自动退还,并写入一条「退款」日志。
不要只根据「失败」状态判断额度是否已经退回。请同时查看钱包余额(或订阅剩余额度、所用 API 密钥的额度),以及使用日志中的「退款」记录。如果失败任务长时间没有退款记录,请带上任务 ID 联系 support@zero.cat。

通过接口查询

如果希望在自己的系统里查询日志,可以用个人访问令牌调用以下 管理接口(只返回你自己的数据)。创建访问令牌时需要勾选「用量 → 查看」权限。 列表接口使用分页参数 p 和 page_size,页码从 1 开始,page_size 最大为 100。 使用日志和日志统计的单次查询时间范围有上限,超出时接口会返回错误。 另外,GET /api/log/token 可以直接用某个 API 密钥(放在 Authorization 请求头中)查询它最近的调用日志,不需要个人访问令牌,最多返回最近 1000 条。

与数据看板的关系

  • 日志是逐条明细,数据看板 是按时间、模型等维度聚合后的统计。
  • 两者的统计口径和刷新时机可能不同;新请求会先出现在日志中,图表可能稍后才更新。
排查某一次调用时,先在使用日志中按时间、模型、请求 ID 或上游请求 ID 找到这条记录;异步请求请记下提交时返回的 task_id,再查询任务的最终状态和失败原因。