文档 / 费用与充值

使用日志与账单

「使用日志」记录每次请求的模型、用量和实际扣费,用来对账。

找到一次请求

  1. 按调用时间找到对应记录。注意客户端和控制台的时区可能不同。
  2. 用页面上的条件筛选:时间范围、令牌名称、模型名称、分组、请求 ID。
  3. 查看扣费、输入输出 token、缓存、首字时间和总耗时。点开一条记录能看到计费明细。

报错信息末尾的 request id 可以直接填进「请求 ID」筛选,定位到那次请求。

导出

点日志页的「导出」,选择一段时间(最长 365 天),会把这段时间内符合当前筛选条件的记录导出为 CSV 文件。

视频和异步任务

视频生成等异步任务在「任务日志」里查看,能看到任务状态、进度和结果。任务失败会自动退回费用,并在日志里留下退款记录。

用密钥查询余额

创建或编辑密钥时打开「允许查询用户额度」,就可以在程序里用这把密钥查余额:

curl -sS https://api.peroai.cc/api/usage/token/ -H "Authorization: Bearer $PEROAI_API_KEY"

返回里的数字是内部额度单位,除以 500,000 就是美元:

字段 含义
data.total_used 这把密钥累计用掉的额度
data.total_available 这把密钥剩余的额度(无限配额的密钥没有意义)
data.user_quota.total_available 账户剩余余额(需要打开「允许查询用户额度」)
data.user_quota.total_used 账户累计消耗

部分客户端用 OpenAI 旧版的 /dashboard/billing/subscription 接口查余额,本站也支持。

为什么客户端报错了,仍然扣了费

客户端断开、超时或没收到完整回复时,上游可能已经处理完了请求。有没有扣费以使用日志为准,不能只看客户端是否显示成功。

反过来,找不到记录也不一定表示没处理:请求可能还在进行,或者失败发生在计费之前。

看不到错误详情

使用日志不一定包含所有失败请求。请保存客户端里的 HTTP 状态码、错误正文、时间和 request id,按故障排查处理。

核对账单时提供记录里的必要信息就够了,不要发送密钥、密码或完整的私人对话。

最后更新:2026-11-15。模型、价格和分组以控制台实时显示为准。