X6.AI

账户余额

Markdown 版本

示例中的 <BASE_URL> 替换为 https://api.x6.ai。详见 接入点。

查询当前 API Key 所属组织的可用余额(对外卖价口径,USD)。

GET <BASE_URL>/v1/billing/balance

认证

必需:Authorization: Bearer <API_KEY>(与对话接口同一 Key)。

请求

无 Query、无 Body。

响应(200)

{
  "balance": {
    "value": "12.345678",
    "currency": "USD"
  }
}
字段说明
balance.value十进制字符串,可用余额(会随消费下降)
balance.currency通常为 USD

口径:

  • 积分订阅组织:剩余积分按平台默认倍率(1000 积分 = $1)折算为 USD。
  • 按量(PAYG):可用 = 账面信用 − 当日待结算卖价 − 欠款 − 冻结(不是未扣减的账面总额)。

探针可在调用前后各拉一次,用余额差粗算扣费;精确单笔请用 单请求对账。

相关