--- title: "查询账户余额" description: "通过开放接口查询 XiuAI 账户余额与累计消耗,并使用六位小数金额进行计算。" image: "https://docs.xiu.ai/og.png" --- > XiuAI 文档索引 > 完整文档索引:https://docs.xiu.ai/llms.txt > 阅读前先通过索引确认当前可用页面。 # 查询账户余额 读取密钥所属账户的当前余额与累计消耗。需要 `balance:read` 权限;尚未拿到密钥时,先在控制台[获取密钥](/open-api/#获取密钥)。 ```http GET /open/v1/balance ``` 没有请求参数。 ```json { "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`,不会用零代替读取失败。 认证方式见[首次查询](/open-api/#认证与首次查询)。查询失败时,按[错误与限频说明](/open-api/errors/)处理。 源文件:https://docs.xiu.ai/open-api/balance/index.mdx