Credit-Nutzung und Warteschlange per API abrufen

Ihr API-Schlüssel liest, was jede Engine und jeder Schlüssel verbraucht hat und wie viel Platz Ihr Plan für neue Aufgaben hat.

Was Sie erhalten

• GET /v1/usage: die berechneten Credits und Aufgaben in einem Zeitraum von UTC-Daten, aufgeteilt nach Tag, Engine und API-Schlüssel.
• GET /v1/async/status: Ihre wartenden und laufenden Aufgaben, die wartenden Aufgaben nach Priorität und Ihr Parallelitätslimit.
• Beide lesen Sie mit demselben vt_-Schlüssel, mit dem Sie Aufgaben senden.

So funktioniert es

Die Nutzung summiert, was Aufgaben berechnet wurde. Credits werden abgebucht, wenn eine Aufgabe abgeschlossen ist, und eine fehlgeschlagene Aufgabe kostet 0. credits und tasks auf oberster Ebene sind die Summe aller Zeilen, und eine Kombination ohne Abbuchung hat keine Zeile.

Teilen Sie nach key auf, um zu sehen, wer die Credits verbraucht hat. Aufgaben Ihrer Unterkonten zählen zu Ihrer Nutzung, und apiKey.subAccountId nennt das Unterkonto, dem ein Schlüssel gehört.

Die Warteschlange zählt QUEUED- und PROCESSING-Aufgaben zusammen, so wie das Parallelitätslimit Ihres Plans. Ein Senden über das Limit ergibt 429 PLAN_CONCURRENCY_LIMIT; wer zuerst concurrency liest, hält einen Batch im Limit.

Einsatzbereiche

• Rechnen Sie mit Ihren eigenen Kunden nach Nutzung ab: Geben Sie jedem Kunden einen Schlüssel oder ein Unterkonto und lesen Sie am Monatsende groupBy=key.
• Takten Sie einen großen Batch: Senden Sie so viele Aufgaben, wie max - used zulässt.
• Zeigen Sie den täglichen Verbrauch pro Engine in Ihrem eigenen Dashboard oder Alerting.

So legen Sie los

Lesen Sie die Nutzung dieses Monats nach Engine:

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

UTC-Daten im Format YYYY-MM-DD, beide eingeschlossen. Standard sind der erste Tag des laufenden UTC-Monats und heute. Ein Zeitraum umfasst bis zu 366 Tage.

groupBystring

Beliebige Auswahl aus day, engine und key, durch Kommas getrennt. Standard ist day,engine. Jede Zeile enthält die Felder der gewählten Aufteilung.

rows[].apiKeyobject

Mit groupBy=key der Schlüssel, der die Credits verbraucht hat: id, keyPrefix, name und subAccountId. Verbrauch durch Monitore, den Playground und das Dashboard hat source monitor, playground oder dashboard.

Lesen Sie Ihre Warteschlange:

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

Ihre wartenden und laufenden Aufgaben, einschließlich der Ihrer Unterkonten.

priorityBreakdownarray

Wartende Aufgaben nach der priority, mit der sie gesendet wurden, höchste zuerst.

concurrencyobject

used ist die Summe aus wartenden und laufenden Aufgaben, so wie Ihr Plan sie zählt. max ist Ihr Parallelitätslimit, also ist max - used der Platz für neue Aufgaben.

Fehler

VALIDATION_ERRORHTTP 400

Ein Feld fehlt oder liegt außerhalb des erlaubten Bereichs. details nennt das Feld.

MISSING_API_KEYHTTP 401

Der Header Authorization fehlt, oder sein Schlüssel ist unbekannt, abgelaufen oder widerrufen.

SUB_ACCOUNT_FORBIDDENHTTP 403

Der Schlüssel gehört zu einem Unterkonto. Der Schlüssel des Hauptkontos liest Nutzung und Warteschlange für beide.

Preis

Das Abrufen von Nutzung und Warteschlangenstatus kostet 0 Credits.