通过 API 查看积分用量和队列

用 API 密钥查看各引擎、各密钥消耗的积分，以及套餐还能容纳多少新任务。

获得的结果

• GET /v1/usage：某段 UTC 日期内扣除的积分和任务数，可按日期、引擎和 API 密钥划分。
• GET /v1/async/status：排队中和运行中的任务、按优先级划分的排队数，以及并发上限。
• 两者都使用你提交任务时所用的 vt_ 密钥读取。

工作原理

用量是任务扣除积分的总和。积分在任务完成时扣除，失败的任务为 0。顶层的 credits 和 tasks 是所有行之和，没有扣费的组合不会出现在行中。

按 key 划分即可看到是谁消耗了积分。子账户的任务也计入你的用量，apiKey.subAccountId 指明拥有该密钥的子账户。

队列把 QUEUED 和 PROCESSING 任务合起来计数，套餐的并发上限也这样计算。超过上限的提交会返回 429 PLAN_CONCURRENCY_LIMIT，先读取 concurrency 就能让批量任务保持在上限之内。

应用场景

• 按用量向你的客户计费：为每个客户分配密钥或子账户，月底用 groupBy=key 读取。
• 控制大批量任务的节奏：只提交 max - used 允许的数量。
• 在你自己的看板或告警中绘制各引擎的每日用量。

开始使用

按引擎读取本月用量：

curl "https://api.querying.ai/v1/usage?groupBy=engine" \
  -H "Authorization: Bearer $QUERYING_API_KEY"

{
  "success": true,
  "data": {
    "from": "2026-10-01",
    "to": "2026-10-20",
    "groupBy": ["engine"],
    "credits": 66.25,
    "tasks": 65,
    "rows": [
      { "taskType": "CHATGPT", "credits": 49, "tasks": 49 },
      { "taskType": "GEMINI", "credits": 6.25, "tasks": 5 },
      { "taskType": "PERPLEXITY", "credits": 11, "tasks": 11 }
    ]
  }
}

from, tostring

YYYY-MM-DD 格式的 UTC 日期，包含起止两天。默认为当前 UTC 月的第一天和今天。时间范围最长 366 天。

groupBystring

可任选 day、engine、key，用逗号分隔。默认为 day,engine。每一行包含所选维度的字段。

rows[].apiKeyobject

使用 groupBy=key 时，表示消耗积分的密钥（id、keyPrefix、name、subAccountId）。来自监测、Playground 和控制台的消耗，source 为 monitor、playground 或 dashboard。

读取队列：

curl "https://api.querying.ai/v1/async/status" \
  -H "Authorization: Bearer $QUERYING_API_KEY"

{
  "success": true,
  "queuedTasks": 19,
  "processingTasks": 6,
  "priorityBreakdown": [
    { "priority": 8, "count": 3 },
    { "priority": 1, "count": 16 }
  ],
  "concurrency": { "used": 25, "max": 200 }
}

queuedTasks, processingTasksnumber

排队中和正在运行的任务数，包含子账户的任务。

priorityBreakdownarray

按提交时的 priority 统计排队任务，从高到低排列。

concurrencyobject

used 为排队与运行中任务之和，与套餐上限的计算方式相同。max 是并发上限，因此 max - used 就是还能放入新任务的余量。

错误

VALIDATION_ERRORHTTP 400

缺少字段或取值超出范围。details 会指明该字段。

MISSING_API_KEYHTTP 401

缺少 Authorization 请求头，或密钥有误、已过期或已吊销。

SUB_ACCOUNT_FORBIDDENHTTP 403

这是子账户的密钥。请用父账户的密钥读取两者的用量和队列。

价格

读取用量和队列状态消耗 0 积分。