余额查询

查询账户总积分余额与单个 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%)时触发通知,避免任务因余额不足失败。