成员账户 · /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-…"}}
| 字段 | 说明 |
|---|---|
shared | boolean,可选。传 true 开启🏢 共享额度模式(推荐),不设个人专属上限,出图直接走企业共享池 |
credits | number,可选。指定👤 专属个人积分(如 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。
相关
接口集成 · 在档 L3「要接进自己的系统」的链路上 —— 本页是这条链的延伸