修复"额度不足"错误

你的套餐额度和余额已用完，或者工作流包含了免费套餐额度无法支付的检查。这里介绍如何找出是哪一项，以及如何避免它再次发生。

如果一次核验请求失败并返回 "You don't have enough credits to perform this request"，或者在你创建会话时 API 返回错误代码 insufficient_credits，说明你组织的余额无法覆盖工作流正在尝试运行的某项功能。同样的原因也可能表现为一个**"额度不足"错误（有时是 502）**，例如工作流包含手机核验或数据库验证，而免费套餐额度不能支付这两项。

#先检查工作流，再检查余额

本能反应是先看用量。但请先看你的工作流，因为每个已启用的模块都从你每月 $10 的额度（免费套餐）中扣费，然后才是余额，而且有些模块比基础四项（证件核验、被动活体检测、1:1 人脸匹配和设备与 IP 分析，合计 $0.33）贵得多。以下是最常见的元凶，按实际出现频率排序：

#解决方法

1. 打开失败会话所使用的工作流

   不是随便一个工作流 - 而是该会话创建时所使用的那个 workflow ID。在工作流程中， 对照上表逐一检查每个已启用的功能。

2. 找到隐藏的自定义样式开关

   白标是一项名为 Include custom style 的按工作流设置，它不在步骤列表中，这就是为什么逐一审查步骤永远找不到它。在工作流编辑器中，它是顶部栏中色板图标旁边的小开关，而且只有当鼠标悬停在该图标上时才会出现，因此一个工作流可能已经启用了品牌定制，却没有人记得做过这件事。同一项设置也位于工作流的 Settings 侧边栏中，在那里它始终可见。

3. 检查你的余额

   设置 → 账单和套餐显示你当前的余额。如果本月额度已用完且余额为零或负数，所有计费工作都会停止， 直到余额恢复到零以上。

4. 要么移除付费功能，要么充值

   如果你不需要这项付费功能，关闭它并重新发布。如果需要，请充值 - 最低充值金额为 $50。 参见充值、发票与付款方式。

#值得排查的其他原因

• 余额为负。 一旦余额降到零以下且你本月的额度已用完，正式环境的检查就会停止。这是该错误确实与某个具体模块无关的情况。
• 用错了应用的密钥。 余额是按组织计算的，但如果你使用的密钥所属应用的工作流，与你审查的工作流不同，那你看的就是错误的配置。参见组织、应用与环境。
• 这是独立 API 调用，而不是工作流会话。 独立调用按标价按次计费，使用相同的额度和余额，因此可能比你预期的更快用完。
• 尚未充值就使用手机核验或数据库验证。 两者在你的组织完成首次真实充值之前都处于未启用状态；免费套餐额度无法解锁它们。参见充值、发票与付款方式。
• 沙盒能用而正式应用不能用。 沙盒从不计费，因此暴露不出付费功能。工作流的真实价格在第一个正式会话中才会显现。
• 你确实用完了本月的 $10。 在下结论之前，先到 Analytics 中查看当月各功能的用量，并到用量页面查看每次检查的扣费。额度在每月 1 日重置。

#避免再次发生

• 在设置 → 账单和套餐中开启自动充值，让余额在低于你设定的阈值时自动补充。
• 在 sandbox 中测试，那里不产生任何计费，余额检查也会被完全跳过。参见在 sandbox 中测试。
• 将测试应用和 live 应用分开，避免一次实验耗尽生产流量所依赖的余额。

#设置支出上限

如果你想设置一个硬性上限，让账户在测试期间无法变为负数，这属于账户级别的控制项，而不是工作流设置 - 请向支持团队咨询你的组织可用哪些选项。与此同时，实用的做法是：继续在 sandbox 应用中测试，那里没有任何东西会产生花费。

#如果充值不能自助完成

年付套餐的组织无法通过自助充值流程购买额度 - 请联系你的客户经理。自助尝试会明确告诉你这一点，而不是静默失败。

#如果你的余额看起来不对

如果你的余额、发票或核验历史突然显示缺失或不正确，这几乎总是平台的临时问题，而不是数据丢失。请联系支持团队，不要自行尝试修复，并附上你的组织 ID。