查询账户余额

GET/v1/billing/balance

返回当前认证账户的可支付余额：钱包可用余额 + Credit 可用余额（USD）。

认证

Authorization Bearer

在 Authorization 请求头中使用 API Key（sk-…）。

响应

codeinteger

响应状态码。

msgstring

响应消息。

dataobject

data.currencystring

币种；当前为 usd。

data.wallet_availablenumber

钱包可用余额（USD）。

data.wallet_frozennumber

钱包冻结余额（USD），如待结算金额。

data.credit_availablenumber

Credit 可用余额（USD）。

data.total_spendablenumber

wallet_available + credit_available。

data.checked_atstring

快照时间（UTC ISO-8601）。

service_codestring

稳定错误码（如有）。

trace_idstring

服务端 trace id（如有）。

余额口径

total_spendable 与计费鉴权使用的可支付余额一致：充值钱包 + 未用完的 Credit。
企业子账号的钱包余额解析到租户主账号；Credit 仍按成员本人账户统计（如有）。

错误处理

401 / 未认证：缺少或无效的 Authorization。

相关接口

GET /v1/billing/{request_id} — 按单次推理的计费 request id 对账。
GET /v1/billing — 按日期范围汇总账户用量与费用；企业主账号可传 sub_account_id 或 key_display 按成员 / API Key 分账查询。

请求

Shell

1curl -sS "https://api.token360.ai/v1/billing/balance" \
2  -H "Authorization: Bearer sk-your-api-key"

响应

JSON

1{
2  "code": 200,
3  "msg": "success",
4  "data": {
5    "currency": "usd",
6    "wallet_available": 12.5,
7    "wallet_frozen": 0,
8    "credit_available": 5,
9    "total_spendable": 17.5,
10    "checked_at": "2026-06-01T12:00:00Z"
11  },
12  "service_code": null,
13  "trace_id": null
14}

此页面对您有帮助吗？