实时监控 Minimax Coding Plan API 用量,自动预警防止超额,适合高频调用场景。
说明:
## 核心用法
Minimax Usage Skill 是一款轻量级 Shell 脚本工具,专为监控 Minimax Coding Plan 的 API 用量设计。用户只需配置 `MINIMAX_CODING_API_KEY` 和 `MINIMAX_GROUP_ID` 两个环境变量,即可通过 `./minimax-usage.sh` 一键获取实时用量数据。脚本调用 Minimax 官方平台接口 `https://platform.minimax.io/v1/api/openplatform/coding_plan/remains`,返回当前周期内已用提示词数、剩余额度及重置倒计时,并以颜色编码(绿/黄/红)直观展示风险等级。
## 显著优点
1. **零依赖设计**:纯 Bash 实现,无需额外运行时或库
2. **即时反馈**:API 响应直接解析,无缓存延迟
3. **智能预警**:内置 60% 用量阈值提醒,预留安全缓冲
4. **周期透明**:动态计算 5 小时滑动窗口的重置时间
5. **用量换算**:明确提示 1 prompt ≈ 15 model calls 的换算关系,便于成本估算
## 潜在缺点与局限性
– **平台锁定**:仅支持 Minimax Coding Plan,不支持标准 API Key 或其他厂商
– **手动配置**:需用户自行从网页控制台提取 GroupId,无 OAuth 自动化流程
– **单账户监控**:一次只能监控一个 GroupId,无多账户聚合视图
– **无历史数据**:仅展示当前周期用量,不提供趋势分析或导出功能
– **Header 硬编码**:依赖固定 user-agent 和 referer,存在因平台反爬策略失效的风险
## 适合人群
– 使用 Minimax M2 系列模型进行代码生成或补全的开发者
– 需要严格控制 API 预算的中小团队或个人项目
– 将 Minimax Coding Plan 集成到 CI/CD 流水线的前置检查环节
## 常规风险
| 风险类型 | 说明 |
|———|——|
| 密钥泄露 | `.env` 文件若未加入 `.gitignore` 可能意外提交 |
| 接口变更 | Minimax 官方调整 Header 校验规则会导致脚本失效 |
| 用量误判 | 5 小时滑动窗口机制可能导致”已重置”幻觉,建议结合业务日志交叉验证 |
| 计划混淆 | Coding Plan 与标准 API 的密钥体系互斥,误用会导致认证失败 |








