余额与用量
Mafdet 有两种相互独立的余额，互不抵扣，各自支付不同的调用：
| API 钱包 | Playground 额度 | |
|---|---|---|
| 用于支付 | API Key 调用（api.mafdet.ai） | 控制台 Playground 的调用 |
| 来源 | 充值 | 订阅套餐，按周期发放 |
| 是否结转 | 是，用完为止 | 否 —— 每周期重置 |
| 用尽时 | 调用被拒，直到你充值 | Playground 停止调用，直到下个周期（或加量包） |
Playground 对话不会动用你的 API 钱包，API 调用也不会消耗 Playground 额度。
API 钱包
钱包是预付的运行额度。每次调用按 (输入 + 输出 token) × 模型单价计费（免费试用模型 除外），单价见模型总览。
并非所有能力都按 token 计费：图片嵌入按张、视频嵌入按秒、语音合成按文本 token + 音频 token 分别计费。每个模型会标注自己的计费单位。
先预留、后结算：调用前系统按预估金额预留，调用结束后按实际用量结算并释放多余部分。 你可能短暂看到「冻结」金额，这是正常的；最终扣费始终以实际用量为准，调用失败会全额释放预留。
当出现 insufficient_credit 或「运行额度不足」提示时：
- 检查当前余额；
- 在线充值——见充值；
- 管理员也可以发放额度（例如测试额度）。
Playground 额度
每个订阅周期都包含一定的 Playground 额度：
| 套餐 | 每周期包含 |
|---|---|
| Free | $0.50 |
| Enterprise | $500.00 |
| Starter | $9.50 |
| Pro | $28.50 |
Playground 调用按与 API 相同的模型单价扣减该额度。控制台会显示当前周期的已用 / 剩余，并在 达到 50%、70%、90%、100% 时通知你。
达到 100% 后 Playground 停止接受调用（PLAYGROUND_CREDIT_EXHAUSTED，HTTP 402），直到下个
周期。单次请求若超过剩余额度，会被提前拒绝（PLAYGROUND_REQUEST_EXCEEDS_REMAINING），而不是
执行到一半。
未用完的额度不结转到下个周期。
加量包
$10 加量包为当前周期增加 $9.50 Playground 额度。它不会延续到下个周期、不进入 API 钱包，也不改变你的套餐。见充值。
费用到底是怎么算出来的
金额以整数微美元（µ$）保存，1 USD = 1,000,000 µ$，全程整数运算。
钱不经过任何浮点数，所以多次扣费不会累积出取整误差。
单个计费维度的费用是：
费用_µ$ = ceil(用量 × 单价_µ$ / 1,000,000)
取整方向永远是向上，取到整数微美元。 以 $0.60 / 1M tokens（= 每 1M 600,000 µ$）为例：
| tokens | 精确值 | 实际计费 |
|---|---|---|
| 1 | 0.6 µ$ | 1 µ$ |
| 7 | 4.2 µ$ | 5 µ$ |
| 1,000 | 600 µ$ | 600 µ$ |
| 1,667 | 1000.2 µ$ | 1001 µ$ |
两条推论值得知道：
- 任何非零用量至少计 1 µ$（
$0.000001）。没有更小的计费单位，也不会向下抹零。 - 多维度计费的模型是逐维度取整，不是最后统一取整。一次对话调用的输入和输出分别取整。
用量记录
控制台的用量 / 账单页会列出每次调用的模型、用量和费用。Playground 调用显示为钱包扣费 $0 ——它们由 Playground 额度支付。
记录在结算之后写入，所以刚结束的调用可能要稍等才出现。你看到的金额是结算金额， 不是预留金额。