Consulte o uso de créditos e a fila pela API

Sua chave de API lê o que cada mecanismo e cada chave gastaram e quanto espaço o seu plano tem para novas tarefas.

O que você recebe

• GET /v1/usage: os créditos e as tarefas cobrados em um intervalo de datas UTC, por dia, mecanismo e chave de API.
• GET /v1/async/status: suas tarefas na fila e em execução, as tarefas na fila por prioridade e o seu limite de concorrência.
• As duas leituras usam a mesma chave vt_ com que você envia tarefas.

Como funciona

O uso soma o que foi cobrado das tarefas. Os créditos são cobrados quando uma tarefa termina, e uma tarefa com falha custa 0. credits e tasks no nível superior somam todas as linhas, e uma combinação sem cobrança não tem linha.

Divida por key para ver quem gastou os créditos. As tarefas das suas subcontas entram no seu uso, e apiKey.subAccountId indica a subconta dona de uma chave.

A fila conta juntas as tarefas QUEUED e PROCESSING, como o limite de concorrência do seu plano. Um envio acima dele recebe 429 PLAN_CONCURRENCY_LIMIT, então ler concurrency antes mantém um lote dentro do limite.

Onde ajuda

• Cobre seus próprios clientes pelo uso: dê a cada cliente uma chave ou uma subconta e leia groupBy=key no fim do mês.
• Ajuste o ritmo de um lote grande: envie só as tarefas que max - used permite.
• Mostre o gasto diário por mecanismo no seu próprio painel ou nos seus alertas.

Como começar

Leia o uso deste mês por mecanismo:

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

Datas UTC no formato YYYY-MM-DD, as duas incluídas. O padrão é o primeiro dia do mês UTC atual e hoje. Um intervalo cobre até 366 dias.

groupBystring

Qualquer combinação de day, engine e key, separados por vírgulas. O padrão é day,engine. Cada linha traz os campos dos cortes escolhidos.

rows[].apiKeyobject

Com groupBy=key, a chave que gastou os créditos: id, keyPrefix, name e subAccountId. O gasto de monitores, do Playground e do painel tem source igual a monitor, playground ou dashboard.

Leia a sua fila:

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

Suas tarefas na fila e em execução, incluindo as das suas subcontas.

priorityBreakdownarray

As tarefas na fila pela priority com que foram enviadas, da maior para a menor.

concurrencyobject

used soma as tarefas na fila e em execução, como o seu plano as conta. max é o seu limite de concorrência, então max - used é o espaço livre para novas tarefas.

Erros

VALIDATION_ERRORHTTP 400

Falta um campo ou o valor está fora do intervalo. details indica o campo.

MISSING_API_KEYHTTP 401

Falta o cabeçalho Authorization, ou a chave é desconhecida, expirou ou foi revogada.

SUB_ACCOUNT_FORBIDDENHTTP 403

A chave é de uma subconta. A chave da conta principal lê o uso e a fila das duas.

Preço

Consultar o uso e o status da fila custa 0 créditos.