Token360
登录注册

查询账户余额

GET/v1/billing/balance

先选择查询范围与凭证

  • 单个 Key 用量/限额：使用该推理 API Key 调用 GET /v1/key，读取 usage、limit_remaining、limit_reset。这是 Key 的消费预算，不是企业钱包或授信余额。
  • 企业钱包与授信：使用仅含 tenant:billing:read 的 MANAGEMENT Key 调用 GET /enterprise/v1/billing/balance。不要用推理 Key 或 PROVISIONING Key。
  • 账户费用汇总/请求对账：现有 GET /v1/billing、GET /v1/billing/requests/{request_id} 使用推理 Key 或登录态 JWT；管理 Key 不能调用这些 /v1 接口。费用明细与余额是不同指标。
  • 旧账户余额接口：GET /v1/billing/balance 保留兼容，返回账户级资金，不代表调用 Key 的剩余预算；新企业余额监控优先使用 Enterprise 接口。

企业 API 指南 · 查询企业余额

后付费资金口径

所有金额单位为 USD。POSTPAY 下优先使用钱包充值余额，不足部分占用企业授信；赠送 Credit／代金券不参与扣费，也不计入总可用。

  • credit_limit_usd：授信总额。
  • current_exposure_usd：当前开放账期已使用的授信。
  • credit_remaining_usd：max(credit_limit_usd - current_exposure_usd, 0)。
  • credit_available：POSTPAY 时等于剩余授信；PREPAY 时为可用代金券余额，二者不可混淆。
  • total_spendable：POSTPAY 为 max(wallet_available, 0) + credit_remaining_usd；PREPAY 保持 wallet_available + credit_available。

历史待付账单不从剩余授信再次扣除。余额是已记录账务数据的查询快照，不是实时资金预留。授信耗尽、Key 限额、账户消费保护或其他策略仍可能拒绝请求；即使钱包尚有余额，授信耗尽也会阻止后付费新请求，因此总可用不等同于保证可调用额度。

身份验证

使用推理 API Key 或登录态 JWT；MANAGEMENT / PROVISIONING Key 不支持此路径。企业成员的钱包和授信均解析到企业账务主账户。

响应

codeinteger

200 on success

dataobject
data.currencystring

币种，固定 usd

data.payment_modestring

PREPAY 或 POSTPAY

data.wallet_availablenumber

钱包可用余额，可为负数

data.wallet_frozennumber

钱包冻结余额

data.credit_availablenumber

PREPAY 为代金券；POSTPAY 为剩余授信

data.credit_limit_usdnumber

授信总额；PREPAY 为 0

data.credit_remaining_usdnumber

剩余授信；PREPAY 为 0

data.current_exposure_usdnumber

当前账期已用授信；PREPAY 为 0

data.total_spendablenumber

按支付模式计算的账户总可用

data.checked_atstring

UTC ISO-8601 查询时间

请求

Shell
1curl "https://api.token360.ai/v1/billing/balance" \
2  -H "Authorization: Bearer $INFERENCE_API_KEY"

响应

JSON
1{
2  "code": 200,
3  "msg": "success",
4  "data": {
5    "currency": "usd",
6    "payment_mode": "POSTPAY",
7    "wallet_available": 20,
8    "wallet_frozen": 0,
9    "credit_available": 70,
10    "credit_limit_usd": 100,
11    "credit_remaining_usd": 70,
12    "current_exposure_usd": 30,
13    "total_spendable": 90,
14    "checked_at": "2026-11-03T00:00:00Z"
15  }
16}

旧接口错误字段为 service_code / trace_id。

此页面对您有帮助吗？
查询账户余额 · Token360