计费与额度

星算 有两层独立的额度拦截。理解它们的区别,有助于排查「为什么请求被拒绝」。

两层额度

层级	谁设置	超额错误码	HTTP
API Key 额度上限	用户创建 / 编辑 Key 时设置	QUOTA_EXCEEDED	429
企业钱包余额	平台 / 租户管理员维护	INSUFFICIENT_BALANCE	402

请求会先校验 API Key 的额度上限,再校验企业钱包余额;任一不通过即被拒绝,且按当前协议返回对应错误信封(见 错误码)。

API Key 额度上限

• 不设置上限 → 无限制(默认);
• 设置为正数 → 累计已用金额达到上限即拒绝;
• 判定按「已用金额 ≥ 上限」,不预扣——请求成功并完成计量后才累计扣减。

企业钱包余额

租户 / 企业层面的钱包余额。余额不足(含授信额度)→ 402 INSUFFICIENT_BALANCE。钱包状态异常(冻结 / 停用 / 关闭)→ 403,分别对应 WALLET_FROZEN / WALLET_SUSPENDED / WALLET_CLOSED。

用量统计

每个 Key 自动累计以下用量(由系统维护,客户端无需上报):

• 累计已用金额:该 Key 历史调用消耗总额;
• 累计请求次数:该 Key 历史调用总次数;
• 最后使用时间:最近一次成功鉴权的时间。

均可在控制台「API 密钥」详情页查看。