RevorRevor

查询积分余额

GET/api/v2/credits

返回 API Key 所属用户当前可使用的总积分。该接口为同步只读接口,不创建任务,也不消耗积分。

请求示例

cURL
curl "https://revor.ai/api/v2/credits" \
  -H "Authorization: Bearer sk-revor-REPLACE_ME"

响应示例

JSON
{
  "ok": true,
  "request_id": "req_xxx",
  "available_credits": 1280,
  "as_of": "2026-08-25T08:00:00.000Z"
}

响应字段

字段类型说明
available_creditsnumber当前可用积分,最低为 0
as_ofISO 8601 string本次余额计算完成的时间。

available_credits 已包含积分分组、有效期和订阅状态等规则。客户端不应自行汇总积分流水来替代该值。

错误

HTTPCode说明
401api_key_invalidAPI Key 无效。
403permission_deniedKey 不具有积分读取权限。
429api_rate_limit_exceeded请求触发限流。
500credits_query_failed积分查询失败;不要把该错误解释成余额为零。