halfoff.dev文档
获取密钥
账户

额度与计费

Half Off Dev 采用美元预付费余额,通过 PayPal 充值,支持兑换码;每个模型请求按官方 token 价格的一半扣费。

Half Off Dev 是先充值、后使用。余额以美元计,每个模型请求按官方定价的一半从余额里扣费。没有套餐,没有月账单,也不会自动从你的卡上续扣:余额用完,请求就停,充值后继续。除了下文提到的少量透支,你的花费永远不会超过充进去的钱。

账户下所有密钥共用这一个余额。

怎么扣费#

项目价格扣费时机
模型请求按 token 计费:输入、输出、缓存读取、缓存写入,各按该模型每百万 token 的单价计算,为官方定价的一半响应结束时
Token 计数(count_tokens、countTokens)免费—
以错误结束的请求免费—

各模型的实时价格见模型列表;每类 token 怎么计算,见模型与价格。每个请求的实际扣费都记录在日志里。

用 PayPal 充值#

  1. 选金额

    在账单页面选择 $10, $25, $50, $100, $250,或者输入 $5 到 $5,000 之间的任意整数美元。

  2. 用 PayPal 付款

    点击 用 PayPal 支付,跳转到 PayPal 后可以用 PayPal 余额或银行卡付款。充值以美元结算。

  3. 回到控制台

    付款成功后,PayPal 会把你带回账单页面,额度几秒内到账。在 PayPal 页面取消不会扣任何钱。

偶尔有付款需要更久才能确认,这时账单页面会显示 支付处理中,款项到账后余额自动更新。一次想充超过 $5,000,分几次充即可。

余额用完时#

余额为 $0 或更低时,模型请求返回 402:

{"type": "error", "error": {"type": "billing_error", "message": "Insufficient balance. Top up at the dashboard."}}

需要知道的几点:

  • 余额检查发生在请求开始时。开始时余额为正的请求一定会完成,哪怕费用超过剩余余额,所以余额可能出现少量负数,下次充值时自动抵扣。
  • 不会停用任何东西。密钥一直有效,充值后重新发请求就行。
  • 密钥用完它自己的消费上限,也会返回 402,但消息不同。参阅 API 密钥。

兑换码#

拿到兑换码后,在账单页面的 兑换充值码 处输入。兑换码以 HO- 开头,例如 HO-7KQ2M9XW4P,不区分大小写,空格会被忽略。金额立即计入余额。

同一账户每个码只能用一次。有些码还设有过期时间或总兑换次数。

提示含义
Code not found没有这个码,检查一下是否输错。
This code has expired已过有效期。
You have already redeemed this code你的账户已经用过这个码。
This code has been fully used兑换次数已被领完。

充值记录#

账单页面列出最近 100 笔入账:充值、兑换码、邀请返佣和人工调整,还有近 30 天每日消费的图表。

这里不列消费明细。每个模型请求及其扣费在日志里;两边怎么对账,见用量与日志。

邀请返佣#

账单页面的 邀请好友 卡片里有你的专属链接 https://halfoff.dev/signup?ref=...。通过这个链接注册的用户,以后每充值一次,你都能拿到充值金额的 5%,对方的款项一到账,返佣就进入你的余额。

卡片上还会显示你邀请了多少人、累计拿到多少返佣。返佣会出现在充值记录中。只有真金白银的充值才计算返佣,兑换码不算。