API Key 管理
创建分组与子 Key、为子 Key 设置限额、吊销与级联规则。
Key 树模型
平台 API Key 支持树形结构:一个主 Key 下可以创建分组,分组下再创建子 Key,子 Key 还可以继续下分,最多 4 层。典型用法:
- 分组:按项目或团队划分,如「数据分析组」「客服机器人」。
- 子 Key:分发到具体成员或服务实例,独立吊销不影响其他 Key。
- 限额:每个 Key 可设置消费限额(元),其子树的总消费不能超过该限额。
创建 Key
在API Keys 页面点击「创建 API Key」:
- 填写名称与所属分组(可选)。
- 选择父 Key(不选则为顶层 Key)。
- 填写限额(可选),单位为元,表示该 Key 及其子树允许消费的总额。
- 创建后密钥明文只展示一次,请立即保存。
计费与限额如何生效
- 调用时系统沿 Key 树自下而上逐级校验:整条链路上的 Key 必须都处于启用状态。
- 每次调用的费用会同时累加到链路上每一级 Key 的已用额度。
- 任一级超出限额,或账户余额不足,调用会返回
402 Payment Required。
吊销与级联
吊销某个 Key 时,它自身立即失效;它下层的子 Key 在下次调用时同样会被拒绝。因此吊销分组即可一键停掉整组服务。
查看用量
API Keys 页面展示每个 Key 的最近调用记录,包含调用时间与费用;完整消费明细见账单流水。