计费与额度

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

两层额度

层级	谁设置	超额错误码	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 密钥」详情页查看。

分时段计费

部分模型按「时段」实行差异化定价:不同时间段的 token 单价不同(高峰上浮 / 低谷折扣)。这类模型在目录价格表中按「项目 × 时段」逐行列出各时段的实际单价(输入 / 输出 / 缓存各计费项均有),表下方标注各时段的生效星期与时间窗口。

计费规则:

• 以请求开始时刻判定时段,整单按一个时段计费——流式响应跨过时段边界不拆分;
• 未命中任何时段(含时段间隙与非生效星期)按基准价计费,基准价即价格表中的基准时段单价;
• 时段基于北京时间(Asia/Shanghai)按普通星期判定,不区分法定节假日;
• 消费记录的「时段」列展示本次调用命中的时段(未命中时显示基准时段名)。