MiniMax Quota Query

---

name: minimax-quota description: MiniMax Token Plan 额度查询工具。当需要查询 MiniMax API 使用量、剩余配额、额度重置时间时使用。支持查询 M2.7 文本、image-01 图片、Hailuo 视频、music-2.5 音乐、speech 语音等模型的用量。触发场景：用户问"查一下 MiniMax 额度"、"Token Plan 还剩多少"、"用量是多少"。

---

MiniMax Quota Query

查询 MiniMax Token Plan 当前用量和剩余配额。

API 信息

Endpoint: https://www.minimaxi.com/v1/api/openplatform/coding_plan/remains

认证: Bearer Token (Token Plan API Key)

重要：字段含义

⚠️ 关键发现: current_interval_usage_count 字段表示的是剩余配额，不是已用量！

已用量 = current_interval_total_count - current_interval_usage_count
剩余配额 = current_interval_usage_count

使用方法

直接 curl 查询

curl -s --location 'https://www.minimaxi.com/v1/api/openplatform/coding_plan/remains' \
  --header 'Authorization: Bearer ' \
  --header 'Content-Type: application/json'

使用脚本查询

uv run python3 scripts/query.py 

或设置环境变量后直接运行：

export MINIMAX_API_KEY="your_api_key"
uv run python3 scripts/query.py

输出示例

==================================================
 MiniMax Token Plan 用量查询
==================================================
【MiniMax-M2.7】
 5小时窗口：已用 1103 / 4500（24%）剩余 3397 次
 本周：已用 0 / 0（0%）剩余 0 次
 窗口：03-22 20:00 ~ 00:00
 重置：约 399 小时后
【image-01】
 5小时窗口：已用 1 / 120（0%）剩余 119 次
 本周：已用 1 / 840（0%）剩余 839 次

模型额度参考

| 模型 | 每日/窗口配额 | 重置周期 | |------|--------------|----------| | M2.7 文本 | 4500次/5小时 | 滚动重置 | | image-01 图片 | 120张/日 | 每日重置 | | Hailuo-2.3 视频 | 2个/日 | 每日重置 | | music-2.5 音乐 | 4首/日 | 每日重置 | | TTS HD 语音 | 11000字符/日 | 每日重置 |