Crédits et limites : prix, blocages, concurrence et limites de débit

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

​

Crédits par tâche

​

Facturation Citation Analysis

​

Blocage, prélèvement et libération

​

Consulter votre solde

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 correspond à ce que vous pouvez dépenser maintenant. Les tâches déjà soumises bloquent leur prix dans reserved : ne le soustrayez pas une seconde fois.
• perCycle est ce que votre plan accorde à chaque cycle, et cycleResetsAt la fin du cycle en cours. Les deux valent null sans plan actif.
• topUpBalance indique les crédits de recharge compris dans remaining, avec la date à laquelle les prochains expirent et leur nombre. Il vaut null si vous n’en avez pas. Les crédits de recharge durent trois mois après l’achat, sont conservés lors des renouvellements et sont dépensés après les crédits du plan.

​

Consulter votre utilisation

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 et to sont des dates UTC, et les deux jours sont inclus. Par défaut, ce sont le premier jour du mois UTC en cours et aujourd’hui. Une plage couvre 366 jours au plus.
• groupBy accepte day, engine et key, séparés par des virgules, et vaut day,engine par défaut. Une ligne porte les champs des ventilations choisies, et une combinaison sans facturation n’a pas de ligne. credits et tasks en tête additionnent toutes les lignes.
• groupBy=key montre qui a dépensé les crédits. Une tâche envoyée avec une clé d’API a "source": "api" et un apiKey avec son id, keyPrefix, name et subAccountId. Une dépense sans clé d’API a source à monitor (les exécutions d’un moniteur), playground ou dashboard, et apiKey vaut null.
• L’utilisation additionne ce qui a été facturé aux tâches, et une tâche échouée coûte 0. La lecture des concurrents d’un moniteur est facturée sans tâche : elle fait baisser votre solde mais n’apparaît pas dans l’utilisation.
• Les tâches de vos sous-comptes figurent dans votre utilisation, et apiKey.subAccountId désigne le sous-compte propriétaire d’une clé. GET /v1/sub-accounts/{id}/usage lit un seul sous-compte. La clé d’un sous-compte reçoit 403 SUB_ACCOUNT_FORBIDDEN.

​

Consulter votre file

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 vaut queuedTasks plus processingTasks, les deux compteurs que la limite de concurrence de votre plan additionne. max est cette limite : max - used est la place restante pour de nouvelles tâches.
• priorityBreakdown liste les tâches en file selon la priority avec laquelle elles ont été soumises, de la plus haute à la plus basse.
• Les compteurs incluent les tâches de vos sous-comptes, qui partagent votre limite. La clé d’un sous-compte reçoit 403 SUB_ACCOUNT_FORBIDDEN et lit ses propres compteurs sur GET /stats.

​

Plans

​

Concurrence du plan

​

Limites par clé et par sous-compte

​

Débit des requêtes et contre-pression

​

Cadencer les grosses soumissions