Key 管理
Key 的作用
API Key 用于标识你的账号、分组或授权范围。无论你通过终端工具、IDE 插件还是脚本访问中继，都应先确认自己正在使用的是当前实例签发且仍有效的 Key。
使用前先确认什么
- Key 属于哪个账号或分组
- 是否已经过期或被禁用
- 是否有额度、频率或模型范围限制
- 是否需要配合特定基础地址使用
安全使用建议
- 优先通过环境变量注入 Key，不要硬编码到脚本或仓库中。
- 不要把完整 Key 直接发到工单、群聊或截图里。
- 如果需要排障，只提供脱敏后的 Key 标识。
- 多个工具共用同一 Key 时，先确认额度窗口和速率限制是否足够。
轮换建议
当出现以下情况时，应考虑轮换 Key：
- 怀疑 Key 已泄露
- 接入人员或设备发生变更
- 需要切换套餐、分组或权限边界
- 旧 Key 即将过期或已经不再使用
轮换时建议先创建新 Key、完成验证，再下线旧 Key，避免直接中断线上请求。
常见排查方向
如果请求被拒绝、额度异常或客户端表现不一致，优先检查：
- Key 是否复制完整
- 环境变量是否被正确加载
- 当前客户端是否读取了错误的配置文件
- Key 是否和当前基础地址属于同一实例
- 是否触发了额度、频率或策略限制
联系支持时建议提供
- 脱敏后的 Key 标识
- 问题发生时间
- 使用的客户端或工具
- 受影响的模型或接口
- 错误信息、响应体或截图