读懂密钥列表
打开API 密钥。页面可按名称、API 密钥和状态筛选,「查看」用于调整显示列。常用列如下:
| 列名 | 要检查什么 |
|---|---|
| 名称 | 是哪个客户端、项目或测试任务在用 |
| 状态 | 是否「已启用」,停用后客户端将无法继续使用这把密钥 |
| API 密钥 | 默认以掩码显示,复制完整值时注意保密 |
| 额度 (¥) | 有限额度或无限制状态,以及已用额度 |
| 分组 | 指定分组或自动路由,以及跨分组设置 |
| 模型、IP 限制 | 是否限制了当前请求的模型或来源 |
| 时间、过期 | 创建时间、最后使用时间和到期设置 |
| 操作 | 「禁用」「编辑」及更多菜单 |
窄窗口看不到右侧列时,横向滚动表格;不要把缺少可见列误认为功能不存在。公开反馈问题时,不要截取完整密钥或用量明细中的私人信息。
修改额度、分组或有效期
- 确认这把密钥实际用于哪个应用,必要时先暂停该应用的自动任务。
- 点击该行「编辑」。
- 修改「分组」「过期时间」「额度设置」或「高级设置」中的限制。编辑
auto时同时检查候选分组与跨分组重试。 - 点击「保存更改」,回到列表复核刚修改的值。
- 在对应应用测试一条短消息,再到「使用日志」核对模型、分组与费用。
修改名称、额度或期限是改配置,不能让已经泄露的密钥字符串失效。要换凭证,需要创建一把新的 API Key 并切换应用。
不停业务地更换密钥
- 按创建密钥教程新建密钥,例如「网站服务-新密钥」,配置正确的分组、模型和预算。
- 在客户端设置或服务端密钥存储中替换旧值;需要重启或重新加载配置的程序,完成相应操作。
- 用新密钥验证业务所需的聊天、流式或工具调用。
- 确认所有设备、定时任务和服务实例都已切换后,在旧密钥那一行点击「禁用」。
- 观察应用和日志。长期不再使用的密钥,再按页面提示清理;不确定用途时先保留为停用状态。
不要先停用正常业务唯一使用的密钥,再开始寻找配置位置。多个应用共用旧密钥时,应逐个完成切换。
怀疑泄露时的处理顺序
泄露应急以停止异常消费为先。 立即禁用可疑密钥,再核对异常时间段、模型、分组和费用,创建新密钥并更新应用。清除公开仓库、截图或日志里的泄露内容,不能代替停用密钥。
如果同时发现异常登录,再去「安全与访问」处理会话和密码。不要把新密钥发给客服;反馈时间、密钥名称、请求 ID 和脱敏错误即可。