使用日志与账单
「使用日志」记录每次请求的模型、用量和实际扣费,用来对账。
找到一次请求
- 按调用时间找到对应记录。注意客户端和控制台的时区可能不同。
- 用页面上的条件筛选:时间范围、令牌名称、模型名称、分组、请求 ID。
- 查看扣费、输入输出 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,按故障排查处理。
核对账单时提供记录里的必要信息就够了,不要发送密钥、密码或完整的私人对话。