MiniMax Usage Query
查询 MiniMax API 账户的剩余配额和用量统计，支持查看每个模型的使用情况。
Quick Reference
| 任务 | 命令 |
|---|
| 查询账户余额/用量 | bun run ${CLAUDE_SKILL_DIR}/scripts/query.ts |
| 检查环境变量 | echo $MINIMAX_API_KEY |
前置要求
必需：设置 MiniMax API Key
export MINIMAX_API_KEY="your-api-key-here"
⚠️ 注意: 如果不设置此环境变量，脚本将报错退出。
使用方式
进入 skill 目录执行
# 在项目根目录运行
bun run ${CLAUDE_SKILL_DIR}/scripts/query.ts
# 或使用快捷命令
bun run ${CLAUDE_SKILL_DIR}/scripts/query.ts
输出示例
================================
Minimax Account Usage
================================
Model: abab6.5s-chat
--------------------------------
Period: 2024-03-01 00:00 to 2024-03-31 23:59
Quota: 10000 requests
Used: 2345 requests (23.5%)
Remaining: 7655 requests
Resets In: 5d 12h 30m
================================
Query Time: 2024-03-25 14:30:00
================================
常见场景
执行大批量任务前检查余额
# 在批量生成图片/语音前，先检查额度
bun run ${CLAUDE_SKILL_DIR}/scripts/query.ts
定期监控配额使用
# 添加到 crontab 定期提醒
0 9 * * * /path/to/minimax-usage/scripts/query.sh >> /var/log/minimax-usage.log
排查 API 调用失败
# 如果 API 返回 429 或 403，先检查是否超额
bash scripts/query.sh
❌ WRONG / ✅ CORRECT
❌ WRONG - 直接 curl 而不检查环境变量
# 不要直接写 curl，没有错误处理
curl -H "Authorization: Bearer $MINIMAX_API_KEY" \
https://www.minimaxi.com/v1/api/openplatform/coding_plan/remains
✅ CORRECT - 使用提供的脚本
# 脚本会自动检查环境变量并提供友好的错误提示
bun run ${CLAUDE_SKILL_DIR}/scripts/query.ts
❌ WRONG - 不使用环境变量
# 不要在命令中直接写 API key
bash scripts/query.sh --key "sk-xxx"
✅ CORRECT - 使用环境变量
# 先设置环境变量，再执行脚本
export MINIMAX_API_KEY="your-api-key"
bash scripts/query.sh
错误处理
常见错误及解决方案
| 错误信息 | 原因 | 解决方案 |
|---|
Error: MINIMAX_API_KEY environment variable is not set | 未设置 API Key | 执行 export MINIMAX_API_KEY="your-key" |
Error: Failed to connect to Minimax API | 网络连接失败 | 检查网络连接，确认能否访问 minimaxi.com |
Error: Authentication failed | API Key 无效 | 检查 API Key 是否正确，是否已过期 |
Error: Rate limit exceeded | 请求过于频繁 | 稍后再试，或检查当前用量 |
API 返回的错误码
| status_code | 含义 | 处理建议 |
|---|
| 0 | 成功 | - |
| 1004 | 认证失败 | 检查 MINIMAX_API_KEY 是否有效 |
| 2038 | 需要实名认证 | 在 MiniMax 平台完成实名认证 |
| 429 | 请求频率过高 | 降低请求频率，稍后再试 |
输出字段说明
| 字段 | 说明 |
|---|
Model | 模型名称（如 abab6.5s-chat） |
Period | 计费周期起止时间 |
Quota | 当前周期总配额 |
Used | 已使用次数及百分比 |
Remaining | 剩余可用次数 |
Resets In | 配额重置倒计时 |
注意事项
- 额度周期：MiniMax 配额按自然月重置，非购买日起算
- 多模型配额：不同模型可能有独立的配额限制
- 缓存延迟：API 返回的数据可能有短暂延迟（通常 < 5 分钟）
