剩余积分 · 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 分,消耗标准 |
identity | tenant 或 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
}| 字段 | 类型 | 说明 |
|---|---|---|
balance | number | 🏢 企业总积分池:企业当前持有的积分总存量 |
spendable | number | ⚡ 当前可调配活额:走企业共享额度的成员出图可用、或划拨给新专属额度的活额 |
reserved | number | 🔒 专属已预留:已划分给特定成员且尚未消耗的专属积分锁定总量 |
unmetered | boolean | 是否为不限额特权企业 |
三者满足:balance = spendable + reserved。 当管理员为成员设置专属个人积分时,输入的值不得大于 spendable + (该成员现有专属积分)。详见积分的划分机制。
接口集成 · 在档 L3「要接进自己的系统」的链路上 —— 本页是这条链的延伸