跳到主要内容

使用 API Key 查询用量与余额

MuskAI 已支持使用现有 API Key 查询该 Key 的用量及可用余额，不需要另外创建 Profile Key。

查询接口不会产生模型调用费用。建议为不同项目分别创建 API Key，便于独立统计和排查异常请求。

快速查询​

将 YOUR_API_KEY 替换为你在 MuskAI 用户中心创建的 API Key：

curl -sS "https://api.muskapi.cc/v1/usage" \
  -H "Authorization: Bearer YOUR_API_KEY"

也可以把 API Key 保存到环境变量，避免重复出现在命令历史中：

export MUSKAI_API_KEY="YOUR_API_KEY"

curl -sS "https://api.muskapi.cc/v1/usage" \
  -H "Authorization: Bearer $MUSKAI_API_KEY"

:::tip API 地址 如果用户中心显示的推荐 API 地址与示例不同，请以用户中心的【API 密钥】页面为准。查询路径固定为 /v1/usage。 :::

返回内容​

接口会根据 API Key 的计费方式返回不同字段：

字段说明
modeunrestricted 表示钱包或订阅模式；quota_limited 表示 Key 自身配置了额度或速率限制
balance / remaining钱包余额、订阅剩余额度或 Key 剩余额度
quotaAPI Key 金额额度，包含 limit、used、remaining 和 unit
request_quota按请求次数计费的额度，包含总次数、已用次数和剩余次数
rate_limitsKey 的 5 小时、1 天或 7 天速率窗口及重置时间
usage.today当前 Key 今日的请求量、Token 用量和费用
usage.total当前 Key 的累计请求量、Token 用量和费用
daily_usage最近若干天的每日用量
model_stats指定日期范围内按模型汇总的用量

钱包模式的精简响应示例：

{
  "mode": "unrestricted",
  "isValid": true,
  "balance": 18.52,
  "remaining": 18.52,
  "unit": "USD",
  "usage": {
    "today": {
      "requests": 12,
      "input_tokens": 42000,
      "output_tokens": 3500,
      "actual_cost": 0.42
    },
    "total": {
      "requests": 186,
      "actual_cost": 7.81
    }
  }
}

在脚本中提取余额和用量​

下面的示例需要安装 jq：

curl -sS "https://api.muskapi.cc/v1/usage" \
  -H "Authorization: Bearer $MUSKAI_API_KEY" |
  jq '{
    remaining: (.balance // .remaining // .quota.remaining // .request_quota.remaining),
    unit: (.unit // .quota.unit // .request_quota.unit),
    today: .usage.today,
    total: .usage.total
  }'

只读取剩余额度：

REMAINING=$(curl -sS "https://api.muskapi.cc/v1/usage" \
  -H "Authorization: Bearer $MUSKAI_API_KEY" |
  jq -r '.balance // .remaining // .quota.remaining // .request_quota.remaining')

echo "Remaining: $REMAINING"

查询每日用量和模型统计​

curl -sS \
  "https://api.muskapi.cc/v1/usage?days=30&timezone=Asia%2FShanghai&start_date=2026-07-01&end_date=2026-07-18" \
  -H "Authorization: Bearer $MUSKAI_API_KEY"

参数说明：

  • days：返回最近多少天的 daily_usage，允许范围为 1～90 天。
  • timezone：每日统计使用的时区，例如 Asia/Shanghai。
  • start_date、end_date：model_stats 的统计日期范围，格式为 YYYY-MM-DD。

未提供日期时，模型统计默认查询最近 30 天。

网页查询​

不方便使用命令行时，可以打开 API Key 用量查询页面，粘贴 API Key 后查看余额、额度、每日用量和模型统计。

查询范围​

  • 用量数据只统计当前用于鉴权的 API Key，不会自动合并账户下的其他 Key。
  • 钱包余额属于用户账户共享余额，因此同一用户的多个钱包模式 Key 会看到相同余额。
  • 如需分别统计项目用量，建议每个项目使用不同的 API Key。
  • 已耗尽额度或已过期的 Key 仍可尝试查询自身用量；已禁用、已删除或无效的 Key 会返回鉴权错误。

安全建议​

  • 只通过 Authorization 请求头发送 API Key，不要把 Key 放入 URL 参数。
  • 不要把完整 API Key 写入代码仓库、日志、截图或工单。
  • 在服务器脚本中优先使用环境变量或密钥管理服务。
  • 如果怀疑 Key 已泄露，请立即在用户中心禁用或删除，并创建新 Key。

常见的鉴权错误如下：

{
  "code": "API_KEY_REQUIRED",
  "message": "API key is required in Authorization header (Bearer scheme), x-api-key header, or x-goog-api-key header"
}

出现该错误时，请确认请求头格式为：

Authorization: Bearer YOUR_API_KEY