账户余额
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):
可用 = 账面信用 − 当日待结算卖价 − 欠款 − 冻结(不是未扣减的账面总额)。
探针可在调用前后各拉一次,用余额差粗算扣费;精确单笔请用 单请求对账。