11book / docs

文档中心

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

文档目录 · 账号与密钥管理

▪ account

账号与密钥管理

控制台的完整使用指南:API Key 的创建、隔离与回收,充值、返利与账户安全设置。

为什么建议创建多个 Key

所有 Key 共享同一个账户余额,但每个 Key 有独立的用量记录与额度上限。为每个项目、每台机器、每个环境(开发/生产)创建独立 Key,你可以:

  • 在用量统计中按 Key 拆分成本,看清每个项目的真实消耗;
  • 给测试项目设一个很低的额度上限,避免失控循环烧掉生产余额;
  • 某个环境的 Key 疑似泄露时,只停用这一个,不影响其他环境。

创建 Key 时的两个关键设置

在API Keys 页点击「创建 Key」,弹窗中有两组选项:

  • 额度上限:默认「不限额度」,随账户余额使用。选择「设置上限」后, 该 Key 额度用尽后会拒绝后续调用,适合控制项目预算;已发出的请求仍需结算。 上限以美元计,可随时通过删除重建调整。
  • 有效期:默认永久。为临时项目、外包协作设一个 30/90 天有效期, 到期 Key 自动失效,无需人工回收。

停用、启用与删除

  • 停用:阻止该 Key 的后续调用,配额、用量记录全部保留, 随时可以重新启用——适合临时封禁某个环境、排查用量异常。
  • 删除:不可恢复。该 Key 的历史用量明细仍保留在账单中, 但无法再创建相同 Key。确认不再使用时才删除。

推荐的处理顺序:发现异常 → 先停用 → 排查原因 → 确认废弃后再删除并换新 Key。

充值方式

在余额充值 页:

  • Stripe 国际卡支付:选择档位或输入自定义金额,弹窗会显示 预计支付金额(含分档折扣),确认后跳转 Stripe 收银台,支持 Visa / Mastercard 等国际卡。
  • 兑换码:在控制台「兑换码」页提交有效兑换码,成功后核对余额。 兑换码可能设有有效期,到账金额以兑换结果为准。

余额永久有效、无月费、无最低消费。所有充值记录(含实付金额与状态)在 「购买记录」中可查。

账户设置

在设置 页可以修改显示名与登录密码。 注意:出于安全设计,修改显示名同样需要输入当前密码确认。 修改密码后其他已登录会话保持有效,如需强制下线请手动退出各端。

邀请返利

在邀请返利 页复制你的专属邀请链接或邀请码。 好友通过链接注册后,其每笔消费都会按当前活动比例为你产生返利; 返利累计在「待划转返利」中,随时可一键划入余额直接用于调用。 规则详情见邀请返利说明。

给团队的建议

  • 不要多人共享同一个 Key——失去按人/按项目审计的能力,泄露面也更大。
  • 为每个成员或每个项目建独立 Key 并设置额度上限,成本一目了然。
  • 离职或项目结束:停用对应 Key 即可立即切断访问,历史账单不受影响。
The Final Page

万万不可

wan wan bu ke · never, ever

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

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