查询企业余额

查询认证企业的账户余额和授信，不接受 user/tenant 查询参数。

身份验证

使用 Authorization: Bearer <MANAGEMENT_KEY>，Key 必须含 tenant:billing:read。推理 Key、PROVISIONING Key、登录态 JWT 均不支持。认证用户必须仍为企业主账号。

企业 API 指南 · 查询企业余额

后付费资金口径

所有金额单位为 USD。POSTPAY 下优先使用钱包充值余额，不足部分占用企业授信；赠送 Credit／代金券不参与扣费，也不计入总可用。

• credit_limit_usd：授信总额。
• current_exposure_usd：当前开放账期已使用的授信。
• credit_remaining_usd：max(credit_limit_usd - current_exposure_usd, 0)。
• credit_available：POSTPAY 时等于剩余授信；PREPAY 时为可用代金券余额，二者不可混淆。
• total_spendable：POSTPAY 为 max(wallet_available, 0) + credit_remaining_usd；PREPAY 保持 wallet_available + credit_available。

历史待付账单不从剩余授信再次扣除。余额是已记录账务数据的查询快照，不是实时资金预留。授信耗尽、Key 限额、账户消费保护或其他策略仍可能拒绝请求；即使钱包尚有余额，授信耗尽也会阻止后付费新请求，因此总可用不等同于保证可调用额度。

成功响应 code: 200，data 内为 snake_case；错误信封使用 serviceCode / traceId。响应包含 Cache-Control: no-store。缺少 scope 返回 API_KEY_SCOPE_DENIED；凭证类型不符不能获得数据。

响应