Balance Whale 实时算力账单与资费预算指示器

Balance Whale 实时算力账单与资费预算指示器

@meteornox/balance-whale-widget·v1.0.4·protocols

为个人开发者与小型团队定制的轻量级 API 消费监测挂件。实时统计各大模型供应商余额与消耗速率,提供桌面悬浮告警、成本预测曲线与低额度熔断保护。

费用监测 · 余额指示器 · 成本控制 · 预算告警

GitHubNPM
快速安装与集成
bash
manager:
$ pnpm add @meteornox/balance-whale-widget

架构解析

「Balance Whale」彻底告别模型账单超支焦虑。很多开发者在跑通自动化脚本或评测程序时,往往因为没有注意模型单价与消耗速度,第二天一早醒来发现账户被扣除成百上千美元,甚至因欠费导致业务全面瘫痪。 本扩展在开发者工作区常驻一个轻量小巧的鲸鱼仪表盘组件。它能跨供应商(DeepSeek、OpenAI、Anthropic 等)实时查询官方 API 账户的当前可用余额与本月账单,计算每小时的实时资金流速,并在余额跌破安全红线时主动触发系统通知或切断非核心流量,守护开发者的每一分钱。

核心特性

01

多供应商统一余额看板:一处即可聚合查看所有模型账户的真实资金状况

02

精准的每小时资金流速计量:直观了解当前跑批任务每小时正在花费多少成本

03

自定义低额度安全红线:在欠费停机前提前向手机或邮件推送充值预警通知

04

极低后台资源占用:极简轮询逻辑,内存占用小于 5MB 且零额外网络开销

核心机制

01

跨平台余额即时查询

通过安全 API 凭证静默查询各大供应商官方账户的当前可用余额。

02

流速与月度账单预估

结合当前时间窗口的 Token 消耗速率,线性预测本月累计开销。

03

微型挂件仪表盘渲染

在 Web 界面角落或终端标题栏以小巧精致的数字指示器实时更新数据。

04

低余额熔断防护

余额触碰安全临界线时,提前发出警报并自动终止批量消耗脚本。

配置参数参考 (YAML / JSON)

参数名类型默认值说明
warningThresholdUsdnumber10.0触发低余额红色告警的临界金额(美元)
pollIntervalMinutesnumber15向供应商查询账户余额的轮询间隔(分钟)
haltOnDepletionbooleantrue余额低于安全线时是否自动中止非关键批处理任务