用量与费用查询
想确认「这一次调用到底扣了多少」，有三种方式。
方式一：控制台日志（最直观）
登录 187api.com → 日志 页，可以看到每条调用的：
- 模型名
- 输入 / 输出 token 数
- 缓存命中 token
- 扣费金额
- request id
这是排查计费争议的首选入口。
方式二：令牌用量接口
用令牌本身查（不需要面板 PAT）：
curl https://187api.com/api/usage/token/ \
-H "Authorization: Bearer ***"
响应：
{
"code": true,
"message": "ok",
"data": {
"object": "token_usage",
"name": "我的令牌",
"total_granted": 100000,
"total_used": 12500,
"total_available": 87500,
"unlimited_quota": false,
"model_limits": {},
"model_limits_enabled": false,
"expires_at": 0
}
}
| 字段 | 含义 |
|---|---|
total_granted | 总额度（已用 + 剩余） |
total_used | 已消耗 |
total_available | 剩余可用 |
unlimited_quota | 是否为无限额度令牌 |
model_limits | 该令牌限制的模型列表 |
model_limits_enabled | 是否开启了模型限制 |
expires_at | 过期时间戳，0 表示长期有效 |
信息
user_quota 字段默认不返回 —— 需要在令牌上开启「允许查询用户额度」才会带上。
方式三：流式响应里的 usage
流式请求时，平台会自动注入 stream_options.include_usage，最后一条 chunk 里带 token 用量，不需要手动加：
{
"choices": [],
"usage": {
"prompt_tokens": 1211,
"completion_tokens": 86,
"total_tokens": 1297,
"prompt_tokens_details": {
"cached_tokens": 1148
}
}
}
非流式请求的 usage 在响应体顶层。
单次调用的实际花费
单次调用的扣费由请求模型档位 + 实际 token 用量决定：
费用 = 输入 token × 输入倍率 × 分组倍率
+ 输出 token × 输出倍率 × 分组倍率
- 缓存命中 token × 输入倍率 × 缓存倍率 × 分组倍率
缓存部分的计算见 提示词缓存。
:::warning 计费身份 = 请求里的模型名
日志里的 model_name 是你请求的档位，不是上游实际跑的模型。
这是设计如此，见 模型披露说明。
:::
查额度明细
控制台 → 数据看板 可以看到：
- 当前余额
- 历史消耗
- 请求次数
- 统计额度
排错
| 现象 | 说明 |
|---|---|
| 日志里没有这次调用 | 请求在鉴权/限流阶段就被拒了，没到计费环节 |
| 扣费比预期高 | 检查是否命中缓存；缓存读是输入价的 10% |
| 扣费比预期低 | 可能命中了缓存写入减免 |
total_available 为 0 | 余额耗尽，充值后恢复 |