跳到主要内容

创建与管理 API Key

在 Fluxlane 控制台创建、查看、限制和轮换 API Key,以及密钥泄露后的处理步骤和日常安全建议。

入口​

控制台「API 密钥」页(/keys)。所有 API 调用都使用这里创建的密钥鉴权。

创建密钥​

  1. 点击「创建 API 密钥」。
  2. 填写名称,按需设置下表中的限制选项。
  3. 保存后立即复制完整密钥,存放到环境变量或密钥管理服务中。

建议不同项目、不同环境(开发 / 测试 / 生产)分别创建密钥。这样某个密钥出问题时,可以单独停用而不影响其他业务,用量也能分开核对。

限制选项​

选项用途
剩余配额限制该密钥的最大消费
过期时间到期自动失效
模型限制只允许调用指定模型
IP 白名单只允许指定出口 IP 调用
分组选择渠道与计费策略

各选项对调用的影响和触发后的报错见配额、分组与访问限制。

查看与复制​

API 密钥在列表中默认掩码显示,可随时在控制台查看或复制完整密钥。

轮换与泄露处理​

疑似泄露时:

  1. 立即在控制台删除旧密钥。
  2. 创建新密钥,替换到使用方。
  3. 在「使用日志」中按该密钥检查异常调用,见用量与请求日志。
  4. 排查泄露来源,例如是否写入了前端代码、公开仓库或日志。

计划内轮换时,可以先创建新密钥并完成替换,确认旧密钥不再有调用后再删除。

安全建议​

  • 每个应用使用独立密钥,生产环境启用 IP 白名单。
  • 通过环境变量或密钥服务保存密钥,禁止写入前端与公开仓库。
  • 为生产密钥设置独立配额,并监控异常用量。
  • 管理员使用唯一的强密码,并启用两步验证或通行密钥(如已开放)。
  • API Key 等同调用权限。平台工作人员不会索取你的完整 Key 或密码。