点数不足时接口会怎样？

次数包用尽时接口返回错误码 10002，不会自动去扣账户点数，也不会静默降级——这是有意设计的，免得账户余额在你不知情的时候被一个死循环刷光。

返回什么

次数包耗尽后，接口仍然返回 HTTP 200，响应体里带错误码：

请特别注意前两个是不可重试的错误。客户端如果对所有非成功响应一律重试，遇到 10002 会打出一片无效请求，还可能触发频率限制。建议在代码里把这两个码单独分支处理，直接走告警而不是重试。

为什么不自动扣点数

次数包和账户点数是两个口袋：次数包是你为某个产品预付的调用额度，点数是通用余额。如果次数包一用完就自动从点数扣，一个写错的循环调用可以在几分钟里把整个账户余额花光，等你发现已经晚了。所以默认行为是停下来报错。

确实希望不中断的话，可以在 用户中心 打开「次数包用尽后自动使用点数」，并同时设置一个每日点数消耗上限——两个一起设才安全。

提前避免

• 在用户中心设置余量提醒阈值，剩余低于阈值时发邮件，别等归零。
• 次数包余量在 API 响应头里也会返回，客户端可以顺手记录，做成自己的监控指标。
• 调用量有明显周期性的（比如每月 1 号跑批），提前一天补购，别卡着点。

网页工具侧

付费工具在点数不足时会直接提示并给出充值入口，不会扣掉不完整的结果。免费工具不消耗点数，任何时候都能用。