新手最常见的一次踩坑:账户里明明有钱,接口却报额度不足;或者免费额度还剩着,却以为要先充钱。这两个数字分别记在不同的地方,管的也是不同的事。这篇把余额、可用额度、冻结与预扣放在一张表里对齐口径,再给一套能照着走的排查顺序,让你在充值前后、报错当下都知道该看哪一项。
新手最容易踩的坑,是账户里明明有钱,接口却回一句额度不足;或者页面上一堆免费额度没用完,自己却先冲进去充值。这两个数字分别记在不同位置,管的也不是同一件事。余额回答的是「你还有多少钱」,额度回答的是「你还能用多少量」。把它们混在一起,就会在报错当下做错动作。
下面先把两笔账的口径对齐,再说明白为什么余额会突然变少、额度却纹丝不动,然后给出一套遇到报错时照着走的排查顺序。每一步都告诉你该去哪个页面核对数字,而不是凭记忆猜。
余额是钱,额度是量:先把两笔账分开
余额通常以货币单位显示,充值、退款、赠送都会动它,它决定的是「账户里还剩多少钱可以花」。可用额度常见的单位是 token、调用次数、积分或小时,它决定的是「平台允许你用多少量」。钱够不代表量够,量够也不代表不花钱。
- 账户余额
- 你还剩多少钱可以花,充值和退款直接动它
- 可用额度
- 你还能用多少量,是平台单独配置的使用上限
- 赠送额度
- 平台额外给的使用量,扣减顺序和自有余额不一定相同
- 配额上限
- 按模型、按并发档位分别设的量,可能单独用尽
- 余额充足不等于能随便跑:很多平台的额度是单独配置的,余额只决定能不能续上
- 额度还在也不代表免费:赠送额度和自有余额的扣减顺序要看平台规则
- 同一个账户下,不同模型或不同并发档位可能各有各的额度,一个用尽不代表全部用尽
- 团队席位共享时,个人看到的余额和团队可用额度可能不同步,以管理员侧汇总为准
为什么余额会「变少」,但额度没动
不少人发现余额莫名少了一截,但额度没变化,第一反应是被扣费了。多数情况下这是预扣或冻结:请求发起时先冻结一部分余额,结算完成后再按实际消耗回补或扣走。中间那段时间余额显示偏低属于正常现象,不是真的扣了那么多。
| 现象 | 可能原因 | 该看什么 |
|---|---|---|
| 余额忽然变低 | 预扣冻结未结算 | 去 /usage 按时间戳对齐流水 |
| 余额慢慢减少 | 按量计费已结算 | 核对用量记录与实际调用量 |
| 余额不变但报错 | 额度上限用尽 | 查是总额度还是某模型额度 |
| 充值后仍报错 | 生效有延迟 | 等一段时间再复测一次 |
- 结算时点:按量计费的余额变化通常滞后于调用,别拿充值到账的瞬间去对账
- 冻结规模:并发高或长上下文任务可能触发更大的额度预留,看起来像钱莫名其妙少了
- 排查动作:把余额流水和用量记录按时间戳对齐,先确认是冻结还是真扣,再判断是不是额度问题
- 别急着补钱:确认是预扣的情况下,重充反而让账面更乱
看数字的地方:别凭记忆,去页面上核对
判断余额和额度,最怕用记忆里的数字。同一件事在不同页面口径不一样,必须按页面对号入座。官方价格和模型资料到 /official-api 对照,当期具体数字以页面显示为准,不要拿旧截图做判断。
| 要查的东西 | 去哪个页面 | 看什么 |
|---|---|---|
| 官方价格与模型口径 | /official-api | 当期价格与计费方式怎么写 |
| 订阅套餐额度口径 | /plans 与 /coding-plans | 套餐名对应的额度描述 |
| 真实用量与账期 | /usage | 按时间戳的用量记录 |
| 第三方渠道计费口径 | /sites 与 /trends | 余额与额度是分开列还是合并列 |
中转或第三方渠道还要多一层确认:它标注的计费口径是否和官方一致,余额与额度是分开列还是合并成一个数字。分开列说明它至少愿意让你逐项核对,合并成一个数就要多留个心眼。
遇到报错先走这五步,别急着充值
- 第一步:看报错原文写的是「余额不足」还是「额度不足」,这两个词指向完全不同的处理路径,先别急着点充值
- 第二步:看余额流水到 /usage 确认是冻结、预扣还是已结算,避免把预扣当成真扣费
- 第三步:看额度项确认是总额度用尽,还是某个模型、某个并发档位的额度用尽,两者处理方式不同
- 第四步:看生效时间充值和额度重置到账有延迟,隔一段时间再复测一次,别在延迟窗口里反复操作
- 第五步:再考虑升级确认是额度上限而非余额问题,再去 /plans 对比档位,看是不是该换套餐
什么情况下这套判断不适用
上面这套逻辑默认的是「余额用货币单位、额度用使用量单位」的按量计费结构。下面几种情况不能直接套用,硬套会得出错误结论。
- 按次计费或订阅制产品,余额概念可能被折算成积分,不能直接套用货币单位的余额逻辑
- 企业合同或后付费账户,账期出账,实时页面上的数字未必是最终结算值
- 共享账户或团队席位,个人看到的余额与团队可用额度可能不同步,以管理员侧汇总为准
- 跨渠道调用同一模型时,余额和额度分别记在不同平台,别把两边的数字相加当总量
如果你正好处在这些情况里,判断依据就不是页面上的单个数字,而是合同约定或管理员侧的汇总口径。这时候最省事的做法是直接找对应渠道的说明页核对,而不是自己推算。
下一步把余额和额度的区分落到具体平台上才作数。去站内的中转站目录按计费口径筛一遍,重点看它是把余额和额度分开列还是合并列,再决定要不要长期用。→常见问题
余额还有钱,为什么提示额度不足?
这通常说明限制来自使用上限而不是账户资金。额度可能是按模型、按时段或按并发单独设置的,也可能属于赠送额度池。先看报错原文写的是哪一项,再去该平台的额度页面确认是哪一类上限,别直接充钱,充了也解不开量上的限制。
免费额度和充值余额会一起扣吗,顺序是什么?
各平台规则不一样,常见做法是先消耗赠送或免费部分,再走自有余额,但也有按类型分别扣的。判断方法只有一个:去平台的计费说明页看它自己怎么写的,或者用一笔小额调用后对一次流水,看扣的是哪一项。
怎么确认自己看到的是当期数字而不是旧数据?
页面数字通常有更新延迟,尤其是按量结算的场景。做法是记下调用时间戳,隔一段时间再看余额与用量两处是否对得上;如果两边长期不一致,就去核对平台的结算周期说明,而不是反复刷新页面。