- 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
```bash
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.
在 GitHub 查看