why01 API 文档

主题

账户余额 vs 令牌额度 ​

一句话

账户余额是你自己的钱包，调用从这里扣。 令牌额度不是第二个钱包，只是给单把 Key 设的消费上限（一个限额器）——它再大，也绕不过账户余额：余额不足时，Key 的额度设得再高也调不了。

买了订阅套餐的话

订阅额度是另一个独立的包，不在本页讨论范围内。有订阅生效时，调用会先扣订阅包、包用完了才扣余额，所以你会看到余额长时间不动。详见 订阅套餐怎么算。

💰 一份钱 + 一个可选的上限 ​

账户余额令牌额度（单个 Key 的上限）
本质真正的钱，你充值进去的消费上限计数器，不是单独一笔钱
作用范围整个账户，所有 Key 共用一份只管这一把 Key 最多能消耗多少
扣费扣的是就是它——每一笔调用都扣账户余额不扣它；它只是"允许这把 Key 花到多少"的天花板
默认值看你充了多少默认不设——不封顶，直接受账户余额约束

🔗 一次调用怎么判定放行 ​

看两个条件同时满足，扣的始终是账户余额：

账户余额够扣这次吗？ ──否──► 停（名下所有 Key 都调不了，报 402）
      │是
      ▼
这把 Key 累计消耗还没到它的上限吗？ ──否──► 停（只这把 Key，其他 Key 不受影响）
      │是
      ▼
   正常调用 —— 扣的是账户余额

关键理顺主从关系：

  • 账户余额是主——余额见底，名下每把 Key 都一起停，与各自额度设多大无关
  • 令牌额度是从——它只是"最多让这把 Key 花多少"的上限，始终受账户余额约束；给 Key 设上限不等于给它单独充了钱
  • 某把 Key 消耗到自己的上限 → 只有那把 Key 停，换一把没设上限的、只要账户还有余额就照样能用

给 Key 设额度，不会"联动扣空"账户

给某把 Key 设额度上限，是给它单独封顶，不是从账户余额里"划走"这笔钱。比如账户有 100、给某 Key 设上限 20，不代表别的 Key 只剩 80 能用——它只是限制这一把 Key 最多消耗 20，账户那 100 仍是所有 Key 共享的总池子。

🙋 我需要给 Key 设额度吗 ​

自己一个人用，通常不用——留默认（不设上限），跟着账户余额走最省心。

真正该设上限的，是 Key 有可能"跑飞"或"落到不可控地方"的场景：

场景为什么建议设
Key 交给朋友 / 第三方防止对方（或对方泄露后）刷光你全部余额
Key 装进 IoT 设备 / VPS / 别人的电脑Key 落到不可控环境，封顶 = 兜底
给 Agent 工具用（Claude Code / Codex 等）长任务 + 工具循环容易失控，封顶后跑飞也只烧这把 Key

设法很简单：编辑 Key →「额度」填一个数字。详见 修改令牌设置 § 给一个 Key 单独设上限。

❓ 常见疑惑 ​

我充的钱会过期吗 ​

不会，账户余额永久有效。

Key 额度扣空了，钱去哪了 ​

没"去哪"——额度只是个消费上限计数器，不是单独的一笔钱。扣空表示这把 Key 累计消耗到了你设的上限，把上限改大它就能继续用。

余额不足报什么错 ​

402（余额不足）。去 钱包 充值即可，不会透支、不会欠账。

🚀 下一步 ​