| name | minimax-usage |
| description | Check MiniMax API usage and quota. Triggers on phrases like "minimax usage", "minimax quota", "check API usage", "remaining units", "current interval usage". Fetches the current_interval_usage_count and remaining quota from the MiniMax API. |
MiniMax Usage
Overview
Check your MiniMax API usage by calling the MiniMax platform API endpoint. Uses precise Python time calculations to correctly determine interval boundaries and next reset times.
Files
scripts/minimax-usage.py — Main script that fetches and reports usage
Usage
python3 scripts/minimax-usage.py -c `path to run config.yml`
Output Format
The script outputs a horizontal bar chart for each model, e.g.:
📊 MiniMax Usage Report — 2026-03-27 08:30 UTC+8
**MiniMax-M***
███████████████░░░░░ Usage: 73% (440/600)
███████░░░░░░░░░░░░░ Time: 36% (3h 10m) ⏱️
Next reset: 15:00 UTC+8
Each █ block represents 5% (20 blocks = 100%). Empty slots are shown as ░.
Usage Reset Schedule
Resets at 00:00, 05:00, 10:00, 15:00, 20:00 (UTC+8) — every 5 hours.
| Interval | Start | End |
|---|
| 00:00–05:00 | 00:00 | 05:00 |
| 05:00–10:00 | 05:00 | 10:00 |
| 10:00–15:00 | 10:00 | 15:00 |
| 15:00–20:00 | 15:00 | 20:00 |
| 20:00–00:00 | 20:00 | 00:00 (+1 day) |
Time Calculation Rules
- At exact reset time (HH:00:00.000): The NEW interval has just begun
- After reset (HH:MM:SS with M/S/MS > 0): In the current interval
- At midnight with past-time (00:01+): Still in 00:00–05:00 interval
Key Interpretation
current_interval_usage_count = remaining quota (NOT used count)current_interval_total_count = total allowed in interval- Used = total − remaining
If the API returns {"base_resp":{"status_code":1004,"status_msg":"cookie is missing, log in again"}}, the cookies have expired — refresh them in your browser and update the env var.
