11book / docs

文档中心

从第一次调用到生产排错,按场景找到可直接复制的配置。

文档目录 · 安全最佳实践

▪ security

安全最佳实践

Key 的保管与泄露处置、项目隔离策略,以及你的请求数据会如何被处理。

Key 的保管

  • API Key 等同于账户余额的支付凭证——任何拿到 Key 的人都能消耗你的余额。不要把 Key 写进代码仓库、日志、聊天记录或截图。
  • 代码中通过环境变量注入,例如:BOOK_API_KEY=sk-xxxx(配合 .env 并确认它已被 .gitignore 排除)。
  • 线上服务使用密钥管理服务(如各云厂商的 Secrets Manager), 而不是明文写在部署脚本或容器镜像里。

泄露了怎么办

如果你怀疑 Key 已经泄露(出现在公开仓库、被他人使用、用量异常增长), 处置顺序是:

  1. 立即在API Keys 页停用该 Key ,阻止后续调用;已发出的请求仍需核对结算;
  2. 在用量统计中核对最近明细,确认异常消耗的范围;
  3. 创建一个新 Key 替换到你的应用中;
  4. 确认无遗留依赖后删除旧 Key;
  5. 如确认产生非本人消耗,联系 [email protected] 并附上时间与明细。
停用比删除更适合作第一步:它可逆、即时,且保留完整用量记录便于事后核对。

项目隔离策略

  • 每个项目、每个环境一把独立 Key,并为每把 Key 设置额度上限;
  • 测试环境使用低价模型并设置较低额度上限,控制异常消耗;
  • 临时协作用带有效期的 Key,到期自动失效,避免「发出去就收不回」;
  • 定期核对用量统计中按 Key 的消耗分布,出现不认识的 Key 或异常增长立即处理。

你的请求数据如何处理

  • 请求内容(prompt、补全结果)仅用于路由、计量与计费:把请求转发到上游模型、统计 token 用量、生成账单明细。
  • 11book 不使用请求内容训练模型,不对外出售;为完成调用,请求会转发给上游模型服务。
  • 账单逐条可审计:每次调用的时间、Key、模型、token 数与金额都记录在 用量统计中,你可随时核对。
  • 更完整的条款见服务条款与隐私政策。

账户层安全

  • 使用至少 8 位的独立密码,不要与其他站点复用;
  • 修改显示名等账户信息需要输入当前密码,这是有意为之的防护设计;
  • 公共电脑使用后记得退出登录(设置页 → 退出)。
The Final Page

万万不可

wan wan bu ke · never, ever

用户怕什么,我们万万不可什么。这是我们的承诺,也是名字里「万万」的意思。

01万万不可静默降级
02万万不可泄漏密钥
03万万不可糊涂收费
04万万不可暗改价格
05万万不可让额度过期
06万万不可跑路失联
BASE URLhttps://api.11book.ai/v1