创建与管理 API Key
在 Fluxlane 控制台创建、查看、限制和轮换 API Key,以及密钥泄露后的处理步骤和日常安全建议。
入口
控制台「API 密钥」页(/keys)。所有 API 调用都使用这里创建的密钥鉴权。
创建密钥
- 点击「创建 API 密钥」。
- 填写名称,按需设置下表中的限制选项。
- 保存后立即复制完整密钥,存放到环境变量或密钥管理服务中。
建议不同项目、不同环境(开发 / 测试 / 生产)分别创建密钥。这样某个密钥出问题时,可以单独停用而不影响其他业务,用量也能分开核对。
限制选项
| 选项 | 用途 |
|---|---|
| 剩余配额 | 限制该密钥的最大消费 |
| 过期时间 | 到期自动失效 |
| 模型限制 | 只允许调用指定模型 |
| IP 白名单 | 只允许指定出口 IP 调用 |
| 分组 | 选择渠道与计费策略 |
各选项对调用的影响和触发后的报错见配额、分组与访问限制。
查看与复制
API 密钥在列表中默认掩码显示,可随时在控制台查看或复制完整密钥。
轮换与泄露处理
疑似泄露时:
- 立即在控制台删除旧密钥。
- 创建新密钥,替换到使用方。
- 在「使用日志」中按该密钥检查异常调用,见用量与请求日志。
- 排查泄露来源,例如是否写入了前端代码、公开仓库或日志。
计划内轮换时,可以先创建新密钥并完成替换,确认旧密钥不再有调用后再删除。
安全建议
- 每个应用使用独立密钥,生产环境启用 IP 白名单。
- 通过环境变量或密钥服务保存密钥,禁止写入前端与公开仓库。
- 为生产密钥设置独立配额,并监控异常用量。
- 管理员使用唯一的强密码,并启用两步验证或通行密钥(如已开放)。
- API Key 等同调用权限。平台工作人员不会索取你的完整 Key 或密码。