文档目录
BILLING & USAGE
计费、余额与用量
了解页面标价、实际生效倍率和 API Key 用量之间的关系，并通过只读接口核对当前 Key 的计费状态。
了解计费倍率
TokenSupply 采用基于模型官方 API 标准单价的倍率计费。当前公开结算倍率为 0.2×，即输入、缓存输入和输出等各项本站单价均为对应官方标准单价的 20%。每项费用按实际 Token 用量独立计算，并汇总为本次请求的最终费用。
本站单价 = 对应计费项的官方 API 标准单价 × 0.2
请求费用 = 输入 Token 费用 + 缓存输入 Token 费用 + 输出 Token 费用
定价页用于估算，计费接口用于确认公开页面展示当前标准方案。用户级倍率、分组配置或峰值倍率可能改变某个 Key 的最终倍率，因此自动化程序应读取计费自省接口。
查询实际生效倍率
GET /v1/sub2api/billing 返回当前 API Key 的只读计费快照。响应禁止缓存，适合客户端显示或接入前核对，不应在每个生成请求前重复调用。
curl https://www.tokensupply.net/v1/sub2api/billing \
-H "Authorization: Bearer $TOKENSUPPLY_API_KEY"{
"object": "sub2api.key_billing",
"schema_version": 1,
"billing_scope": "token",
"group_rate_multiplier": 0.2,
"resolved_rate_multiplier": 0.2,
"peak_rate_enabled": false,
"effective_rate_multiplier": 0.2,
"observed_at": "2026-07-28T08:00:00Z"
}- group_rate_multiplier
- API Key 所属分组设置的基础倍率。
- user_rate_multiplier
- 用户存在单独倍率时返回；没有覆盖设置时省略。
- resolved_rate_multiplier
- 合并分组和用户设置后得到的基础倍率。
- effective_rate_multiplier
- 计入当前峰值规则后，本次快照实际有效的 Token 倍率。
- observed_at
- 服务端生成该计费快照的 UTC 时间。
查询余额与用量
GET /v1/usage 使用当前 API Key 鉴权，并根据 Key 的类型返回余额模式、订阅模式或限额模式数据。可附加 days 查询最近 1–90 天的每日用量。
curl "https://www.tokensupply.net/v1/usage?days=30" \
-H "Authorization: Bearer $TOKENSUPPLY_API_KEY"| 返回模式 | 适用情况 | 主要信息 |
|---|---|---|
| unrestricted | 余额计费或订阅分组 | 余额/订阅信息，以及可获取时的请求、Token、费用和每日用量。 |
| quota_limited | Key 设置了总额度或时间窗口限额 | 额度、已用、剩余、状态、重置时间，以及可获取时的用量统计。 |
可选的 start_date 和 end_date 使用 YYYY-MM-DD，用于模型统计范围。days 超出 1–90 会返回 400。
对账建议
- 接入时记录 effective_rate_multiplier，不要只写死公开倍率。
- 按请求保存服务端返回的请求标识，并在控制台用量记录中交叉核对。
- 展示费用时明确计价单位，避免混用每 Token 与每百万 Token 的单价。
- 为用量接口设置短时缓存；倍率快照在配置变化后重新获取。