查询任务列表

查不到某个 task_id 的时候用这个 —— 它把最近的任务按时间倒序列出来，每条带状态和花费。

请求

curl "https://api.lk888.ai/v1/skills/usage?detail=1&days=7&limit=50" \
  -H "Authorization: Bearer $OPENAI_API_KEY"

参数	说明
detail	1 返回逐条记录（records）；不传或 0 返回按模型聚合的 by_model
scope	key（默认，只算这次调用用的这把 Key）或 user（同账户所有 Key 汇总）
days	往前推几天，默认 1，最大 30
start_time / end_time	更精确的区间，要一起传；跟 days 冲突时以这两个为准
model	只看某个模型
limit	每页条数，默认 50，最大 200
offset	从 0 开始翻页

时间格式支持 RFC3339 / YYYY-MM-DD HH:MM:SS / YYYY-MM-DD；不带时区就用服务器本地时区。

响应

{
  "total": 128,
  "limit": 50,
  "offset": 0,
  "records": [
    {
      "task_id": 12345,
      "model": "gk-video-3",
      "model_type": "video",
      "state": "success",
      "cost": 1.5,
      "refunded": false,
      "refunded_amount": 0,
      "created_at": "2026-03-17T10:00:00Z",
      "completed_at": "2026-03-17T10:02:13Z"
    }
  ]
}

字段	含义
state	success / failed / running / pending
cost	这条任务扣的算力点
refunded	失败退款时为真
refunded_amount	实际退了多少算力点
model_type	任务类型（video / image / audio…）

顶层还有 total / limit / offset 分页字段。

几个注意点

• 聚合是按任务表、按提交时间算的 —— 排队中、生成中的任务也在列表里，cost 会随实际结算金额变
• 失败退款的任务：records 里 cost 归 0、refunded 为真，退款额在 refunded_amount；汇总口径下这些会并进 refunded_count / refunded_cost，而 by_model[i].cost 是净值（已经扣掉退款）
• 这接口读的是历史消费，不是实时状态 —— 实时余额查 GET /v1/skills/balance，实时任务状态查 GET /v1/skills/task-status

不带 detail 时

detail=0（默认）返回按模型聚合的 by_model 数组：每个模型一行，给出调用次数、成功数、失败数、实际扣费和退款额。要看统计口径用这个，要看单条任务用 detail=1。