OneHop Docs

计费与钱包

预付费钱包、按量付费、充值与退款。

OneHop 从一个预付费钱包计费。你充值一次,之后跨所有供应商的每个请求都从同一余额扣 —— 没有逐供应商的账单,也没有月底惊吓。

扣费如何运作

计费是按量付费(pay-as-you-go)。每个请求:

  1. 开始时按预估在钱包上预留一笔(hold)。
  2. 跑上游并记录真实用量。
  3. 用 OneHop 自己的计价引擎结算精确金额,并释放 hold。

你付的金额完全由 OneHop 内部按自己的价表算出 —— 上游供应商的数字绝不是你被扣金额的真值。

免费模型用量结算为零

部分模型在每日 token 额度内免费提供。符合条件的免费用量仍正常记录,并结算为 0

给钱包充值

在控制台 计费 页充值。结账由 Stripe 处理。

  • 最低实付充值额为 $3(USD)。如果优惠码会把实付金额压到此线以下,会被拒绝, 而不是悄悄抬价。
  • 已购买的 Credit 未消费时可退款,且不过期。
  • 推广/赠送 Credit 可能过期,且不可原路退回支付方式。

Credit 类型

你的钱包可以持有多种 Credit,每种都在 append-only 账本上单独记录:

类型来源说明
购买你的充值未消费可退款,永不过期
充值赠送充值时的促销可能过期
注册赠送新账号发放可能过期
优惠/优惠码活动与兑换码可能过期
邀请返利邀请奖励过持有窗口后释放
补偿客诉/故障补偿由团队发放

退款

有两条退款路径:

  • 用量退款 —— 撤销某次具体请求(例如失败或无效结果),Credit 退回钱包。
  • 充值退款 —— 未消费的购买 Credit 退回你原始的支付方式。

已消费的购买 Credit 不退回卡上。赠送 Credit 不可退款;如需撤销,改在账本上做反向冲销。

负余额

一个很小的宽限地板,让在途请求在余额刚到零的瞬间也能结算而不硬失败。从未充值的账号 地板为零;充值后解锁当前默认宽限。一旦低于地板,新请求会被拒绝并返回 INSUFFICIENT_CREDITS,直到你充值。

在控制台设置低余额提醒,在用尽前就收到通知 —— 见 可观测性与用量