账户与用量

查询账户用量

GET /v1/account/usage

该接口使用与模型调用相同的 API Key 鉴权,不需要控制台登录令牌。它返回 API Key 所属账户的当前余额、请求统计,以及当前 API Key 的配额状态。

curl https://api.vibelab.me/v1/account/usage \
  -H "Authorization: Bearer $LOOPTOKEN_API_KEY"

响应示例

{
  "object": "account.usage",
  "timezone": "Asia/Shanghai",
  "balance": "98.75",
  "month_credits": "12.75",
  "total_recharged_credits": "130",
  "usage": {
    "today": {
      "requests": 12,
      "successful_requests": 11,
      "credits": "1.5"
    },
    "month": {
      "requests": 86,
      "successful_requests": 82,
      "credits": "12.75"
    },
    "all_time": {
      "requests": 240,
      "successful_requests": 231,
      "credits": "31.25"
    }
  },
  "api_key": {
    "used": "20.5",
    "quota": "100",
    "remaining_quota": "79.5"
  }
}

字段说明

字段	类型	说明
`object`	string	固定为 `account.usage`
`timezone`	string	今日和本月统计的时区,固定为 `Asia/Shanghai`
`balance`	string	当前可用积分;提交任务后的预冻结金额已经从该值扣除
`month_credits`	string	本月成功结算请求实际消耗的积分,按 UTC+8 自然月统计
`total_recharged_credits`	string	账户历史充值到账的积分总额;不包含管理员调账、退款或其他流水
`usage.*.requests`	integer	对应周期内的全部请求数,包含失败请求
`usage.*.successful_requests`	integer	对应周期内成功结算的请求数
`usage.*.credits`	string	对应周期内成功结算请求实际消耗的积分
`api_key.used`	string	当前 API Key 的终身累计用量,用于配额控制
`api_key.quota`	string \| null	当前 API Key 的配额;未设置配额时为 `null`
`api_key.remaining_quota`	string \| null	剩余配额,最低为 `0`;未设置配额时为 `null`

积分字段以精确十进制字符串返回,调用方不应使用二进制浮点数进行财务计算。

统计范围与更新时机

balance 和 usage 是 API Key 所属整个账户的数据,包含该账户下其他 API Key 的调用。
api_key 只描述本次鉴权使用的 API Key。
today 按 UTC+8 自然日统计,month 按 UTC+8 自然月统计,all_time 为全部历史记录。
请求结算与用量日志写入可能存在短暂延迟。刚完成调用后立即查询时,余额通常已更新,但用量统计可能稍后才可见。

鉴权错误

缺失、格式错误、已禁用或不存在的 API Key 返回 HTTP 401 和 invalid_api_key。参见鉴权与错误码。

账户与用量

查询账户用量

响应示例

字段说明

统计范围与更新时机

鉴权错误

本页内容