跳到主要内容
Router One
跳到主要内容
Router One
账户

查询余额

返回当前 API Key 所属账号的预付余额,单位 USD。用于服务端监控:定时轮询,在余额耗尽前充值。返回实时值(`Cache-Control: no-store`)。低余额告警请看 `balance`——当前可直接消费的金额,已包含赠送余额。请求进行中时,网关会把预估费用暂时预留在 `reserved_balance`;每个请求结算后,多预留的部分会退回 `balance`,因此高并发时 `balance` 会短暂下探,而 `total_balance` 保持平稳。本接口有独立限流:每个 Key 每分钟 60 次,不占用推理请求的限流配额。

GET
/v1/balance
AuthorizationBearer <token>

使用 API Key 进行认证。在 Router One 控制台获取你的 API Key,格式为 sk-xxx

In: header

Response Body

application/json

application/json

application/json

curl -X GET "https://api.router.one/v1/balance"
{
  "object": "balance",
  "currency": "USD",
  "balance": 12.345678,
  "reserved_balance": 0.5,
  "total_balance": 12.845678
}
{
  "error": {
    "message": "invalid api key",
    "type": "authentication_error",
    "code": "AUTH_INVALID_API_KEY",
    "request_id": "290dd478f91d8aec68f7535e871376eb"
  }
}
{
  "error": {
    "message": "rate limit exceeded",
    "type": "rate_limit_error",
    "code": "RATE_LIMIT_EXCEEDED",
    "request_id": "290dd478f91d8aec68f7535e871376eb"
  }
}