跳到正文
EN

查询账户余额

通过开放接口查询 XiuAI 账户余额与累计消耗,并使用六位小数金额进行计算。

更新于 复核于
查看 Markdown

读取密钥所属账户的当前余额与累计消耗。需要 balance:read 权限;尚未拿到密钥时,先在控制台获取密钥。

GET /open/v1/balance

没有请求参数。

{
  "balance": "1.48",
  "balanceExact": "1.481480",
  "usedBalance": "0.518520",
  "currency": "USD"
}
字段 类型 说明
balance string 当前余额,固定两位小数,用于展示
balanceExact string 同一个余额,固定六位小数,用于程序判断和计算
usedBalance string 累计已消耗金额,固定六位小数
currency string 币种,当前为 USD

balance 和 balanceExact 表示同一笔余额,不要相加。余额按相应小数位向下取整;程序检查余量时使用 balanceExact,避免两位小数掩盖小额差异。从未充值且未使用的账户返回零余额。

金额以十进制字符串返回。计算时使用 Python Decimal、Java BigDecimal 或 JavaScript 十进制库,不要先转成 float、Number 或 parseFloat。余额暂时无法读取时返回 502 upstream_unavailable,不会用零代替读取失败。

认证方式见首次查询。查询失败时,按错误与限频说明处理。

导航

输入关键词开始搜索

↑↓ 移动↵ 打开Esc 关闭