计费说明

计费与错误码

这一页保留并重组当前已经足够实用的计费与错误码内容，适合解释结算逻辑、排查失败请求和设计重试策略。

计费流程

LingCoreX 采用两阶段计费：先做估算预扣费，再按真实 usage 做最终结算。

请求转发到上游之前，平台会先估算这次请求的大致成本，并根据计费账户做预扣费校验。

上游返回真实 usage 之后，平台再按真实 usage 做最终结算，并补扣或退回与预估之间的差额。

这也是为什么有些请求会在还没完整发送到上游前就失败。

同样，这也是为什么最终费用可能和最初估算不同。

下面这些错误码，是工具接入、控制台排查和生产日志里最常见的一批。

错误码	含义	下一步该看什么
401	鉴权失败	先检查 API Key 是否正确，以及请求头格式是否符合预期。
402	余额不足或预算限制导致请求无法通过	检查账户余额、团队余额，或该 Key 的每日限额。
403	权限或分组不匹配	检查这个 Key 的分组是否允许访问当前模型或当前路由。
429	触发限流	降低并发、调整 QPM，并用退避重试而不是直接打满。
502	上游 Provider 异常	记录 request ID，再按故障处理策略决定是否重试。

定价页适合看公开商业信息，首页适合快速理解产品定位。