Consultez votre usage de crédits et votre file depuis l’API

Votre clé d’API lit ce que chaque moteur et chaque clé ont dépensé, et la place que votre forfait laisse aux nouvelles tâches.

Ce que vous obtenez

• GET /v1/usage : les crédits et les tâches facturés sur une plage de dates UTC, par jour, moteur et clé d’API.
• GET /v1/async/status : vos tâches en file et en cours, les tâches en file par priorité et votre limite de concurrence.
• Les deux se lisent avec la même clé vt_ que vos envois de tâches.

Fonctionnement

L’usage additionne ce qui a été facturé aux tâches. Les crédits sont prélevés quand une tâche se termine, et une tâche en échec coûte 0. credits et tasks au niveau supérieur font la somme de toutes les lignes, et une combinaison sans frais n’a pas de ligne.

Découpez par key pour voir qui a dépensé les crédits. Les tâches de vos sous-comptes figurent dans votre usage, et apiKey.subAccountId nomme le sous-compte qui détient une clé.

La file compte ensemble les tâches QUEUED et PROCESSING, comme la limite de concurrence de votre forfait. Un envoi au-delà reçoit 429 PLAN_CONCURRENCY_LIMIT : lire concurrency d’abord garde un lot dans la limite.

Cas d’usage

• Facturez vos propres clients à l’usage : donnez à chacun une clé ou un sous-compte et lisez groupBy=key en fin de mois.
• Cadencez un gros lot : envoyez autant de tâches que max - used le permet.
• Tracez la dépense quotidienne par moteur dans votre propre tableau de bord ou vos alertes.

Pour commencer

Lisez l’usage du mois par moteur :

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

Dates UTC au format YYYY-MM-DD, les deux incluses. Par défaut, le premier jour du mois UTC en cours et aujourd’hui. Une plage couvre jusqu’à 366 jours.

groupBystring

Au choix day, engine et key, séparés par des virgules. La valeur par défaut est day,engine. Chaque ligne porte les champs des découpages choisis.

rows[].apiKeyobject

Avec groupBy=key, la clé qui a dépensé les crédits : id, keyPrefix, name et subAccountId. Les dépenses des moniteurs, du Playground et du tableau de bord ont source à monitor, playground ou dashboard.

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

queuedTasks, processingTasksnumber

Vos tâches en file et en cours d’exécution, y compris celles de vos sous-comptes.

priorityBreakdownarray

Les tâches en file par priority d’envoi, de la plus haute à la plus basse.

concurrencyobject

used additionne les tâches en file et en cours, comme votre forfait les compte. max est votre limite de concurrence, donc max - used est la place restante pour de nouvelles tâches.

Erreurs

VALIDATION_ERRORHTTP 400

Un champ manque ou sort des valeurs admises. details indique le champ.

MISSING_API_KEYHTTP 401

L’en-tête Authorization manque, ou sa clé est inconnue, expirée ou révoquée.

SUB_ACCOUNT_FORBIDDENHTTP 403

La clé appartient à un sous-compte. La clé du compte parent lit l’usage et la file des deux.

Tarif

Lire l’usage et l’état de la file coûte 0 crédit.