▪ security
安全最佳实践
Key 的保管与泄露处置、项目隔离策略,以及你的请求数据会如何被处理。
Key 的保管
- API Key 等同于账户余额的支付凭证——任何拿到 Key 的人都能消耗你的余额。不要把 Key 写进代码仓库、日志、聊天记录或截图。
- 代码中通过环境变量注入,例如:
BOOK_API_KEY=sk-xxxx(配合.env并确认它已被.gitignore排除)。 - 线上服务使用密钥管理服务(如各云厂商的 Secrets Manager), 而不是明文写在部署脚本或容器镜像里。
泄露了怎么办
如果你怀疑 Key 已经泄露(出现在公开仓库、被他人使用、用量异常增长), 处置顺序是:
- 立即在API Keys 页停用该 Key ,阻止后续调用;已发出的请求仍需核对结算;
- 在用量统计中核对最近明细,确认异常消耗的范围;
- 创建一个新 Key 替换到你的应用中;
- 确认无遗留依赖后删除旧 Key;
- 如确认产生非本人消耗,联系 [email protected] 并附上时间与明细。
停用比删除更适合作第一步:它可逆、即时,且保留完整用量记录便于事后核对。
项目隔离策略
- 每个项目、每个环境一把独立 Key,并为每把 Key 设置额度上限;
- 测试环境使用低价模型并设置较低额度上限,控制异常消耗;
- 临时协作用带有效期的 Key,到期自动失效,避免「发出去就收不回」;
- 定期核对用量统计中按 Key 的消耗分布,出现不认识的 Key 或异常增长立即处理。
你的请求数据如何处理
- 请求内容(prompt、补全结果)仅用于路由、计量与计费:把请求转发到上游模型、统计 token 用量、生成账单明细。
- 11book 不使用请求内容训练模型,不对外出售;为完成调用,请求会转发给上游模型服务。
- 账单逐条可审计:每次调用的时间、Key、模型、token 数与金额都记录在 用量统计中,你可随时核对。
- 更完整的条款见服务条款与隐私政策。
账户层安全
- 使用至少 8 位的独立密码,不要与其他站点复用;
- 修改显示名等账户信息需要输入当前密码,这是有意为之的防护设计;
- 公共电脑使用后记得退出登录(设置页 → 退出)。