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