账户与用量

用 API Key 查询账户余额、今日/本月/累计用量、Key 配额，以及单个任务实际扣除的积分

查询账户用量

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 为全部历史记录。
请求结算与用量日志写入可能存在短暂延迟。刚完成调用后立即查询时,余额通常已更新,但用量统计可能稍后才可见。

查询单个任务的消耗积分

GET/v1/tasks/{task_id}/billing

按提交任务时返回的任务 ID 查询实际扣除的积分。鉴权方式与模型调用相同，只能查询 API Key 所属账户的任务。

curl https://api.vibelab.me/v1/tasks/vt_0192f3a8-7c1e-7d4b-9a10-3b5e8c2d6f41/billing \
  -H "Authorization: Bearer $LOOPTOKEN_API_KEY"

{
  "task_id": "vt_0192f3a8-7c1e-7d4b-9a10-3b5e8c2d6f41",
  "model": "seedance-2-0",
  "status": "succeeded",
  "credits_charged": 12.5,
  "created_at": "2026-10-18T03:21:07Z",
  "completed_at": "2026-10-18T03:23:41Z"
}

字段	类型	说明
`task_id`	string	请求中的任务 ID
`model`	string	任务使用的模型
`status`	string	任务状态,取值随任务类型而异,与对应任务查询接口一致
`credits_charged`	number \| null	实际扣除的积分;任务尚未结算时为 `null`
`created_at`	string	任务创建时间
`completed_at`	string \| null	任务结束时间;未结束时为 `null`

支持的任务 ID:

前缀	任务类型
`vt_`	视频
`it_`	图像
`mj_`	Midjourney
`at_`	音频
`avatar_`	数字人素材
无统一前缀	方舟协议视频任务,使用其任务 ID(如 `cgt-...`)

说明:

任务失败、过期或取消时不收费,credits_charged 为 0。
任务运行中或刚结束时,credits_charged 可能暂时为 null,稍后再查。
任务不存在或不属于当前账户返回 HTTP 404 task_not_found;当前 API Key 无权使用该模型返回 403 model_not_allowed。
暂不支持 Kling 旧风格接口的任务和文本对话请求。

鉴权错误

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