账单仪表盘

/app/billing 是你的账单中心,负责订阅管理、用量汇总、返利进度、credit 余额。如果你想实时对账 / 判断要不要订阅 / 看返利还差多少,这是主战场。

如果你要的是逐条请求明细(每次 API 调用用了几 token、花了多少钱),那是另一个页面:/app/usage。两个页面功能不重叠。

/app/billing 有什么

1. 订阅状态卡片(顶部)

显示你当前的订阅状态:

  • Active — 绿色徽章,显示"Pro Plan · 本月 $5(返利后 $X)"
  • Inactive — 灰色徽章,显示"Pay-as-you-go · 未订阅 Pro Plan"

Active 状态下会多一个 取消订阅 按钮(带二次确认)。 Inactive 状态下会多一个 订阅 Pro Plan 按钮,点击后先校验账户余额 ≥ $5,然后即时扣款开通。

2. 本月上游消费进度

一条进度条,显示本月已消费的美元金额,以及到下一个返利门槛还差多少:

本月上游消费:$34.50
[████████████████────────]
下一档:$50(再 $15.50 达成,返 $5,订阅本月免费)

这块是我最喜欢的设计 —— 看着进度条往上走,正向激励感特别强。数字来自 next_rebate_progress() 函数,实时反映 /app/usage 的累计消费。

3. 返利规则速查

把 阶梯返利规则 的核心表以紧凑卡片形式嵌在这里,你不用离开页面就能查:

消费 返利 实际订阅
$0~30 — $5
$30~50 $2 $3
$50+ $5 免费

4. Credit 余额

显示你当前的 credit 余额(来自历史返利),以及上一个结算周期的返利金额。

Credit 永远优先于主余额被消费,所以这个数字会随着你用 API 慢慢下降,直到月末 cron 再给你发新的。

5. 最近账单事件(billing_events 流水)

时间轴式列表,显示最近 10~20 条账单事件:

  • subscription_start — 订阅开通
  • subscription_fee_charged — 月度订阅费扣款
  • rebate_granted — 月度返利发放
  • subscription_canceled — 订阅取消
  • cycle_settled — 月度结算完成

每条带时间戳、金额、描述。如果你对某条有疑问,可以点进去看这条 event 的完整 payload。

6. 历史周期(subscription_cycles)

按月份展开,每个月显示一条汇总:

2026-03
  上游消费:$62.30
  订阅费:  $5.00
  返利:    $5.00 (tier2_free)
  净支出:  $0.00
  credit 入账: $5.00

用来回看"过去几个月我一共花了多少"。这是 Pro 用户最常用的复盘视图。

/app/usage 的定位区别

很多人把两个页面混了,简单区分:

/app/billing /app/usage
粒度 月度汇总 逐请求明细
展示 订阅 / 返利 / credit / 历史周期 请求时间 / 模型 / token / 成本
用途 决定要不要订阅 / 查返利进度 排查某次请求为什么这么贵
数据源 subscription_cycles + billing_events usage_records

想"看大局"去 billing,想"查细账"去 usage。

如果想更深度的对账

/app/billing 的数据已经够 95% 用户用,但如果你有会计 / 报销需求,可能想要:

  • 导出当月所有 billing_events 为 CSV
  • 导出 usage_records 分模型聚合
  • API 形式拉数据做自己的 BI

这些属于 P2 功能,我目前还没做(不想过早过度工程化)。如果你确实需要,发邮件 admin@hyper-ailab.com 告诉我你的场景,用户多我就优先做。

常见问题

Q:为什么订阅按钮是灰的 / 点不动? A:大概率是账户余额 < $5(订阅首月需要直接扣款)。去 /app/topup 兑换一张兑换码,再回来点。

Q:我月初就订阅了,月中想取消,会退钱吗? A:不退。当月已扣的 $5 订阅费不退,但 Pro 权益(Memory 500MB / 独立 workspace 等)维持到月末。下个月回到标准版。这是因为 workspace 的 Anthropic 侧配置是按月计的,我们退不出来上游成本。

Q:credit 能用来抵订阅费吗? A:能。月结 cron 在扣订阅费时会先扣 credit,不够再扣主余额。意思是:如果你上个月刚收到 $5 credit,下个月的 $5 订阅费会被 credit 完全抵掉,主余额 0 扣款。

Q:billing 页面显示的数字跟 /app/usage 对不上? A:正常。billing 是按 cycle(月度)汇总,usage 是按单条请求。usage 是实时的(刚发一条请求就能看到),billing 的上游消费进度也是实时的,但 credit / 订阅费是按结算周期刷新的(月末 cron 跑完才变)。

Q:可以手动提前结算吗? A:不可以,cron 是硬编码按月跑的。如果你有特殊需求(比如企业报销想在月中拿发票),请邮件沟通。

下一步