核心用法
minimax-usage.sh 用于查询 MiniMax 编码计划剩余额度,支持两种模式:
- 直接查询:不带参数时始终输出当前用量(剩余请求数、总配额、百分比、重置时间、剩余时间)。
- 阈值告警:通过
--threshold <percent>仅在剩余百分比低于设定值时输出 Discord 格式告警信息,高于阈值时静默退出(exit 0)。
显著优点
1. 零配置告警:利用 shell 的管道机制,无输出即无告警,天然适配 cron 等自动化调度场景。
2. Discord 原生格式:输出直接兼容 Discord webhook,无需二次处理。
3. 时区友好:自动计算并显示美东时间(ET)的重置时刻及剩余倒计时。
4. 轻量依赖:仅依赖 curl 与 jq,几乎所有 Unix-like 环境均可直接运行。
潜在缺点与局限性
- 单一服务商绑定:仅支持 MiniMax,无法迁移至其他 LLM 服务商。
- 硬编码时区:重置时间固定为 ET,非全球化用户需自行换算。
- 无历史统计:仅展示当前快照,不提供消耗趋势或历史曲线。
- Webhook 需外置:本身不内置通知渠道,需用户自行拼接
discord-webhook等工具。
适合人群
- 使用 MiniMax API 的开发团队,需监控配额避免服务中断。
- 已采用 Discord 作为告警通道的 DevOps/SRE 工程师。
- 希望在 cron 中实现“低配额才通知”的极简监控策略的用户。
常规风险
- 密钥泄露:依赖
MINIMAX_API_KEY环境变量,若在日志或 CI 输出中打印环境变量,可能导致密钥泄露。 - API 可用性:若 MiniMax 服务端限流或变更响应格式,脚本可能异常退出或解析失败。
- 静默失败风险:
--threshold模式下配额充足时零输出,需确保 cron 的 stderr 重定向正确,以免错过脚本自身报错。