Skip to content

成员账户 · /api/tenant-accounts ​

给你手下的人开账号、发 Key、设额度。

只认租户 Key

就是你那把组织级的 sk-studio-。成员账户的 Key 打这个接口一律 403。

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

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

看有哪些成员 ​

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

返回本租户名下账户列表,含各自的 api_key 明文 —— 发给成员用(见账户 Key)。

开户并发 Key ​

bash
curl -X POST https://manager.museav.top/api/tenant-accounts \
  -H "X-API-Key: $MUSEAV_API_KEY" -H "Content-Type: application/json" \
  -d '{
    "action": "create",
    "email": "member@example.com",
    "nickname": "小王",
    "credits": 100
  }'

返回 {"ok":true,"account":{…,"api_key":"sk-studio-…"}}

字段说明
sharedboolean,可选。传 true 开启🏢 共享额度模式(推荐),不设个人专属上限,出图直接走企业共享池
creditsnumber,可选。指定👤 专属个人积分(如 100)。必须不超过当前企业可调配活额

配置 / 调整成员额度(set-quota) ​

支持随时在「共享额度」与「专属个人积分」之间自由切换,或重设专属积分。绝对值覆盖,非增量:

bash
# 切换为 🏢 共享额度模式(走企业共享池,释放个人预留)
curl -X POST https://manager.museav.top/api/tenant-accounts \
  -H "X-API-Key: $MUSEAV_API_KEY" -H "Content-Type: application/json" \
  -d '{
    "action": "set-quota",
    "account_id": "<uuid>",
    "shared": true
  }'

# 或分配 👤 专属个人积分(占用企业活额,受当前可调配上限约束)
curl -X POST https://manager.museav.top/api/tenant-accounts \
  -H "X-API-Key: $MUSEAV_API_KEY" -H "Content-Type: application/json" \
  -d '{
    "action": "set-quota",
    "account_id": "<uuid>",
    "credits": 200
  }'

专属积分的可调配上限

企业总积分池 = 可调配活额 + 成员专属预留。 为某位成员设置专属积分时,最大可设额度 = 当前企业可调配活额 + 该成员现有专属积分。 若超出上限,接口将返回 400 错误 可分配积分不足。查询当前企业活额详见 GET /api/tenant-pool。

其他操作 ​

同一个 POST,换 action:

做什么body
重置某成员的 Key(旧 Key 立即失效){"action":"rekey","account_id":"<uuid>"}
停用 / 启用某成员{"action":"toggle","account_id":"<uuid>","disabled":true}

只能操作本租户名下的账户,越权返回 404。

相关 ​