Minimax Usage (国内版)
Monitor Minimax Coding Plan usage to stay within API limits.
目录结构
~/.openclaw/workspace/skills/minimax-usage-cn/
├── SKILL.md
├── docs/ # (reserved)
├── templates/ # (reserved)
└── scripts/
└── minimax-usage.sh # Main script
功能
- Check current usage quota
- Monitor 5-hour sliding window
- Get usage alerts before hitting limits
When to Use This Skill
Use this skill whenever:
- User asks to check Minimax usage
- Before running large AI tasks
- When approaching limit warnings
API Specification
Endpoint: GET https://www.minimaxi.com/v1/api/openplatform/coding_plan/remains
Headers:
Authorization: Bearer <MINIMAX_API_KEY>
Content-Type: application/json
注意： 此接口仅适用于国内版 www.minimaxi.com。
Response Fields
| 字段 | 含义 | 示例 |
|---|---|---|
remains_time | 订阅周期剩余时间 (秒)，和5小时窗口无关 | 8277752 |
current_interval_total_count | 周期总配额 (固定1500) | 1500 |
current_interval_usage_count | 当前窗口剩余可用次数 | 1263 |
model_name | 模型名称 | MiniMax-M2.5 |
start_time / `end_time | 当前5小时滑动窗口起止时间 (毫秒时间戳) | 1773558000000 |
计算公式（重要！）
# ❌ 错误理解
已用 = current_interval_usage_count # 误以为这是"已用量"
# ✅ 正确理解
剩余 = current_interval_usage_count # 这是"剩余可用次数"
已用 = current_interval_total_count - current_interval_usage_count
使用率 = (current_interval_total_count - current_interval_usage_count) / current_interval_total_count * 100%
示例：API 返回 current_interval_total_count=1500, current_interval_usage_count=1263
- 剩余 = 1263 次
- 已用 = 1500 - 1263 = 237 次
- 使用率 = 237 / 1500 = 15.8%
状态阈值
| 剩余量 | 使用率 | 状态 |
|---|---|---|
| >600 | <60% | 💚 GREEN |
| 375-600 | 60-75% | ⚠️ CAUTION |
| 150-375 | 75-90% | ⚠️ WARNING |
| <150 | >90% | 🚨 CRITICAL |
Output Format
🔍 Checking Minimax Coding Plan usage...
✅ Usage retrieved successfully:
📊 Coding Plan Status (MiniMax-M2.5):
Used: 102 / 1500 prompts (6%)
Remaining: 1398 prompts
Window: 20:00 - 00:00 (UTC+8)
Resets in: 约 1h 13m
💚 GREEN: 6% used. Plenty of buffer.
Status Thresholds
| 使用率 | 状态 | 提示 |
|---|---|---|
| 0-60% | 💚 GREEN | Plenty of buffer |
| 60-75% | ⚠️ CAUTION | Target is 60% |
| 75-90% | ⚠️ WARNING | Approaching limit |
| >90% | 🚨 CRITICAL | Stop all AI work |
Notes
- 需要使用 Coding Plan API Key, 专用于 Coding Plan 套餐
- Coding Plan 用量每5小时重置
- 一个 prompt 约等于 15 次模型调用
current_interval_usage_count是剩余用量，不是已用量！- 窗口时间为 UTC+8 时区
Error Handling
| 错误码 | 含义 | 解决方法 |
|---|---|---|
| 2013 | 参数错误 | 请检查请求参数 |
| 1004 | 未授权/Token 不匹配 | 请检查 API Key |
| 2049 | 无效的 API Key | 请检查 API Key |
| 1002 | 请求频率超限 | 请稍后再试 |
| 2056 | 超出 Coding Plan 资源限制 | 请等待下一个时间段资源释放后，再次尝试 |
| 1000/1024/1033 | 系统错误/内部错误 | 请稍后再试 |