创建与管理 Admin API Keys

在控制台创建密钥

Admin API Key 用于服务端调用组织管理接口,与模型推理 API Key 分开使用。

  1. 使用企业所有者账号登录,打开 Admin API Keys。
  2. 创建密钥并填写便于识别的名称。组织管理选择 MANAGEMENT;仅进行成员与推理密钥配置时选择 PROVISIONING。
  3. 选择最小必要权限。仅监控账单时,明确只选 tenant:billing:read;默认权限可能包含写操作。
  4. 按需设置允许访问的 IP 和有效期,然后创建。
  5. 立即将完整密钥保存到服务端密钥管理系统。完整密钥只展示一次。

查看与撤销密钥

在同一控制台页面查看密钥元数据,撤销不再使用的密钥。列表不会再次展示完整密钥。如果密钥泄露,请撤销并创建替代密钥,更新服务端配置后再恢复使用。

创建与撤销密钥属于控制台操作。公开 API Reference 面向使用 API Key 的服务端集成,不需要从浏览器提取登录会话令牌。

权限与有效期

tenant:members:read / tenant:members:write组织、成员查询与成员管理
tenant:keys:read / tenant:keys:write成员推理密钥管理
tenant:policies:read / tenant:policies:write成员模型权限(仅 MANAGEMENT)
tenant:billing:read余额、用量、账单与请求元数据(仅 MANAGEMENT)
tenant:audit:read密钥管理审计事件(仅 MANAGEMENT)

MANAGEMENT 密钥未设置到期时间时默认不过期。PROVISIONING 默认有效期为 90 天。显式到期时间必须晚于当前时间且不超过 365 天。已有密钥保留原有效期。

在服务端使用

将密钥存放在 ADMIN_API_KEY 环境变量中,通过 Authorization: Bearer $ADMIN_API_KEY 调用文档中的 /enterprise/v1/ 接口。不要放入浏览器代码或提交到代码仓库。这类密钥不能调用模型推理接口。组织写操作可能需要人工审批,请参阅审批与重试。

企业 API 指南

此页面对您有帮助吗?
创建与管理 Admin API Keys · Token360