Créditos e limites: preços, reservas, concorrência e limites de taxa

curl https://api.querying.ai/v1/capabilities

​

Créditos por tarefa

​

Medição do Citation Analysis

​

Reserva, cobrança e liberação

​

Consulte seu saldo

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

{
  "success": true,
  "remaining": 1879939,
  "perCycle": 1000000,
  "cycleResetsAt": "2026-11-14T07:37:57.000Z",
  "reserved": 61,
  "plan": "max",
  "topUpBalance": { "credits": 1000000, "nextExpiresAt": "2027-01-19T10:01:57.000Z", "nextCredits": 1000000 }
}

• remaining é o que você pode gastar agora. As tarefas que você já enviou reservam o preço em reserved, então não o subtraia de novo.
• perCycle é o que seu plano concede a cada ciclo, e cycleResetsAt é quando o ciclo atual termina. Os dois são null sem um plano ativo.
• topUpBalance mostra os créditos de recarga incluídos em remaining, com a data em que os próximos expiram e quantos são. É null quando você não tem nenhum. Créditos de recarga valem por três meses a partir da compra, continuam após as renovações e são gastos depois dos créditos do plano.

​

Consulte seu uso

curl "https://api.querying.ai/v1/usage?from=2026-10-01&to=2026-10-20&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 e to são datas UTC, e os dois dias estão incluídos. Por padrão, são o primeiro dia do mês UTC atual e hoje. Um intervalo abrange no máximo 366 dias.
• groupBy aceita day, engine e key, separados por vírgulas, e o padrão é day,engine. Cada linha traz os campos das divisões que você escolheu, e uma combinação sem cobrança não tem linha. credits e tasks no topo somam todas as linhas.
• groupBy=key mostra quem gastou os créditos. Uma tarefa enviada com uma chave de API tem "source": "api" e um apiKey com id, keyPrefix, name e subAccountId. O gasto sem chave de API tem source igual a monitor (as execuções de um monitor), playground ou dashboard, e apiKey é null.
• O uso soma o que foi cobrado das tarefas, e uma tarefa com falha custa 0. A leitura de concorrentes de um monitor é cobrada sem uma tarefa, então reduz o seu saldo, mas não aparece no uso.
• As tarefas das suas subcontas estão no seu uso, e apiKey.subAccountId indica a subconta dona de uma chave. GET /v1/sub-accounts/{id}/usage lê uma única subconta. A chave de uma subconta recebe 403 SUB_ACCOUNT_FORBIDDEN.

​

Consulte 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 }
}

• concurrency.used é queuedTasks mais processingTasks, os dois números que o limite de concorrência do seu plano soma. max é esse limite, então max - used é a folga que resta para novas tarefas.
• priorityBreakdown lista as tarefas na fila pela priority com que foram enviadas, da maior para a menor.
• As contagens incluem as tarefas das suas subcontas, que dividem o seu limite. A chave de uma subconta recebe 403 SUB_ACCOUNT_FORBIDDEN e lê as próprias contagens em GET /stats.

​

Planos

​

Concorrência do plano

​

Limites por chave e por subconta

​

Taxa de requisições e contrapressão

​

Distribua envios grandes