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