AI Balance Monitor
纯 Python 的多平台 AI 余额监控服务。自定义平台、自定义账号、Telegram 阈值提醒。
功能
- 自定义平台：HTTP 请求（GET/POST）、URL / Headers / Body 模板、
{{apiKey}}占位符嵌入、JSON 余额提取路径（支持data.balance、data[0].balance）、货币单位、图标（@lobehub/icons 键）、监控间隔覆盖 - 账号管理：每个平台下任意账号，API Key 以 Base64 存储
- 监控调度：全局默认间隔 + 平台级覆盖，线程池并发轮询
- 失败处理：网络错误/5xx 自动重试（默认 2 次），仍失败则跳过并记录；401/403 自动禁用该账号并通知
- Telegram 提醒：余额低于阈值提醒一次，恢复到阈值以上发恢复消息后重新武装；认证失败禁用也通知
- 余额历史：每次拉取自动记录，界面可查看趋势
- 完整增删改：平台 / 账号 / 设置均可通过界面或 REST API 管理
- 面板登录：单密码保护，Token 有效期 7 天
快速开始
# 1. 安装依赖
python -m venv .venv
.venv\Scripts\pip install -r requirements.txt
# 2. 修改配置（可选）
# config.json：端口、密码、全局间隔、Telegram
# 3. 启动
.venv\Scripts\python main.py
# 浏览器打开 http://127.0.0.1:8000
配置（config.json）
| 字段 | 说明 | 默认 |
|---|---|---|
port |
服务端口 | 8000 |
password |
面板登录密码 | admin123（请修改） |
global_interval_seconds |
全局监控间隔（秒） | 300 |
retry_count |
网络错误默认重试次数 | 2 |
timeout_seconds |
请求默认超时（秒） | 10 |
max_workers |
并发轮询线程数 | 8 |
telegram_bot_token |
Telegram Bot Token | 空 |
telegram_chat_id |
接收提醒的 Chat ID | 空 |
除
port外，其余均可在界面「设置」页修改并即时生效。改端口需重启。
平台配置说明
- URL / Headers / Body 中统一用
{{apiKey}}占位，添加账号后自动替换为该账号的 API Key - 余额提取路径：点路径或数组索引，如
data.balance、data[0].balance、$.data.balance - Headers / Body 为 JSON 格式；Body 仅在 POST 时发送
- 间隔 / 重试 / 超时 留空则使用全局默认值
- 图标：填 @lobehub/icons 的键（如
OpenAI、DeepSeek、Anthropic），前端内置品牌色映射，未识别时显示平台首字母
示例（OpenAI 余额接口）：
URL: https://api.openai.com/v1/dashboard/billing/credit_grants?api_key={{apiKey}}
Headers: {"Authorization": "Bearer {{apiKey}}"}
路径: data.total_granted
提醒机制
- 余额 < 阈值 → 发送「余额不足」提醒（一次），此后不再重复
- 余额 ≥ 阈值 → 发送「已恢复」提醒，并重新武装（下次再低于阈值会再次提醒）
- 提醒发送成功才更新状态；Telegram 未配置或发送失败时只记录日志，不会误发
- 401/403 → 自动禁用该账号并发送通知；修复后可在界面重新启用
REST API 摘要
认证：POST /api/login 获取 token，之后请求带 Authorization: Bearer <token>。
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /api/login / /api/logout |
登录 / 登出 |
| GET/POST | /api/platforms |
平台列表 / 创建 |
| PUT/DELETE | /api/platforms/{id} |
更新 / 删除（级联删账号） |
| GET/POST | /api/accounts |
账号列表 / 创建 |
| PUT/DELETE | /api/accounts/{id} |
更新 / 删除 |
| POST | /api/accounts/{id}/check |
立即检查 |
| GET | /api/accounts/{id}/history |
余额历史（?limit=） |
| GET/PUT | /api/settings |
设置读取 / 更新 |
| POST | /api/settings/password |
修改密码 |
测试
.venv\Scripts\python -m pytest tests -q
目录结构
main.py 入口
config.json 配置
app/
api.py FastAPI 路由 + 认证
config.py 配置加载/保存
db.py SQLite 数据层
models.py Pydantic 模型
fetcher.py 请求执行 + 重试 + 路径提取
alert.py 阈值提醒状态机
monitor.py 并发调度器
telegram.py Telegram 发送
static/ 前端（HTML/CSS/JS）
tests/ pytest 测试
data/ 运行时生成 SQLite（gitignore）