API Key

接入 MCP 和 REST API 都靠同一个 API Key。Key 只能在你的账号下操作,撤销后立即失效。

创建

  1. 打开 Waper → 设置 → API 与 MCP,点 创建密钥;
  2. 复制保存——Key 只显示一次;
  3. 在同一页的「接入应用」里选你的客户端(Claude Code、Cursor、VS Code、Claude Desktop、Codex 等),复制现成的配置或命令,刚创建的密钥已经填好;REST API 也有可直接运行的 curl 示例。

需要邮箱验证过的账号才能创建 Key。

用它认证

Authorization: Bearer wpr_<key>

管理

重新打开设置、回到 Waper 窗口或浏览器标签页时,列表会刷新最近使用时间。首次使用立即记录,之后一小时内的重复使用不会逐次更新。

  • 列表里能看到每个 Key 的前缀和最近使用时间;每个账号最多 10 把;
  • 撤销立即生效,不可恢复;
  • 建议一个用途一个 Key,丢了撤一个不影响其它;
  • 一把 Key 在一小时内用掉超过 1,800 积分时,我们会给账号的邮箱发一封提醒,写明是哪一把、花在了什么上。是你自己在用就不用管,Key 照常可用;不是你在用,就到这一页撤销它。同一把 Key 一天最多提醒一次,这封邮件只是提醒,不会拦下任何请求。

速率

  • 每个账号每分钟 60 次(MCP 和 REST 共用);
  • 每把 Key 每分钟最多发起 10 个花积分的动作(转写新的音视频、深度研究),超出返回 429 RATE_LIMITED,等一分钟再试;没有每天的次数上限;
  • Agent 对话按实际模型成本扣积分(看积分);
  • REST 的创建类调用支持 Idempotency-Key 请求头(MCP 没有),同一个 Key 24 小时内只执行一次。