管理 API Keys

管理员在 用户 API Keys 页面查看和管理全体成员的密钥，可以代成员新建，也可以调整已有密钥的限制。成员自己创建和使用密钥的说明见 API Keys。

查找 API Key

列表以表格形式展示你权限范围内的全部 API Key。左上角选择字段并输入关键字搜索，右上角的筛选入口可按条件缩小范围，底部可调整每页行数并翻页。

点击右上角新建，选择成员并填写名称即可创建。

需要施加限制时打开 高级设置。配额、过期时间、分组定价和可用模型的含义与成员侧一致：留空时分别表示不限额度、永不过期、使用该成员的分组定价、可调用全部可用模型。

使用 og-auto 等虚拟模型时

限定了可用模型的密钥，按智能路由改写后的实际模型校验。只勾选虚拟模型名没有用，要把它可能用到的每个目标模型和候选模型都加进可用模型，否则请求返回 403，且不会切换到候选模型。目标模型和候选模型以智能路由规则为准。

创建后，密钥在列表中脱敏展示。把完整密钥交给成员时，通过安全的渠道传递。

点击列表中的名称进入详情页，修改后点击右上角更新；不再需要时点击删除。

区域	可以修改的内容
基础信息	名称和分组定价可以修改；部门、用户、状态、密钥和创建时间由系统维护
配额与有效期	勾选无限额度，或填写具体配额；设置过期时间，也可用永不过期、一小时、一天、一个月快捷设置
访问限制	调整可用模型；在 IP 限制中每行填写一个允许访问的地址，留空表示不限制

删除会影响成员的调用

删除无法恢复，会影响正在使用该密钥的应用。因泄漏或离职撤销访问时，先停用并确认同步结果；启用语义缓存时还需验证缓存命中与上游转发路径，见停用访问的核验步骤。调整分组定价或可用模型同样会影响正在运行的应用，修改前先与使用方确认。

现象	检查方向
提示密钥无效	确认密钥是否已被删除，以及成员使用的是不是最新的密钥
提示额度不足	查看列表中的剩余额度。密钥配额用完时提高配额；成员账户额度用完时，通过额度与兑换码补充
提示密钥已过期	在详情页重新设置过期时间
提示模型不存在或无权限	核对详情页的可用模型，以及承载该模型的供应商是否已选择密钥使用的分组定价，见分组定价
部分机器能调通、部分调不通	检查详情页的 IP 限制是否包含这些机器的出口地址
状态是已过期或已耗尽	这两种状态的密钥需要先延长有效期或补充额度，才能恢复调用

需要核对某一次具体调用时，在日志中按用户和 API Key 筛选。