余额查询
查询账户总积分余额与单个 APIKey 的剩余额度,便于客户端做余额预警与自动充值。建议在批量调用前先查询余额。
账户余额
curl https://api.cqtai.com/api/account/balance \
-H "Authorization: Bearer sk-cqt-xxxx"响应字段:
balance:账户当前剩余积分。frozen:处理中任务冻结的积分。lowBalance:是否低于预警阈值,true时建议提示用户充值。
APIKey 维度余额
若单个 APIKey 设置了独立额度,可查询该 Key 的剩余额度:
quota:该密钥的额度上限。used:已消耗额度。remaining:剩余可用额度。
💡 预警建议:当
remaining低于阈值(如总额度 10%)时触发通知,避免任务因余额不足失败。