Skip to content

剩余积分 · GET /api/balance ​

填入你的 API Key本站所有示例里的 $MUSEAV_API_KEY 会就地换成它

只存在你自己浏览器的 localStorage 里,不会发给任何人——本站是纯静态页面,没有后端可发。 共用电脑上看完记得点「清除」。

bash
curl "https://manager.museav.top/api/balance" -H "X-API-Key: $MUSEAV_API_KEY"

返回当前这把身份还能用多少积分。租户 Key 读租户池,账户 Key / 登录会话读这个人的积分。

json
{
  "credits": 80,
  "identity": "tenant",
  "checked_at": "2026-09-05T00:00:00.000Z"
}
字段说明
credits剩余积分。一张标准图 1 分,消耗标准
identitytenant 或 account,跟扣费主体一致

统一积分之后租户和账户都没有人民币「余额」。以前的 balance_cny / balance_usd 已停发。

想看出了多少图、窗口内应付多少,用 /api/tenant-stats。


租户积分池状态 · GET /api/tenant-pool ​

仅租户 Key 可用

企业管理员使用租户组织级 API Key 查询企业总积分池的完整全景(含总池、可调配活额、已预留额度)。

bash
curl "https://manager.museav.top/api/tenant-pool" -H "X-API-Key: $MUSEAV_TENANT_KEY"

返回 JSON:

json
{
  "ok": true,
  "tenant_id": "e7ed2c9e-9a7e-406c-b753-49375c04f3b1",
  "name": "hym",
  "balance": 1009,
  "reserved": 989,
  "spendable": 20,
  "unmetered": false
}
字段类型说明
balancenumber🏢 企业总积分池:企业当前持有的积分总存量
spendablenumber⚡ 当前可调配活额:走企业共享额度的成员出图可用、或划拨给新专属额度的活额
reservednumber🔒 专属已预留:已划分给特定成员且尚未消耗的专属积分锁定总量
unmeteredboolean是否为不限额特权企业

三者满足:balance = spendable + reserved。 当管理员为成员设置专属个人积分时,输入的值不得大于 spendable + (该成员现有专属积分)。详见积分的划分机制。