Batches fassen jetzt 10.000 Aufgaben

Ein Batch speichert bis zu 10.000 Aufgaben und führt sie im Rahmen Ihres Plans aus, und alle bezahlten Pläne führen jetzt mehr Aufgaben gleichzeitig aus.

Was Sie erhalten

• POST /v1/batches nimmt bis zu 10.000 Einträge (32 MiB) an, jeder mit eigenem taskType und payload, und antwortet mit 202 und dem Batch.
• GET /v1/batches/:id meldet den Fortschritt als Anzahl wartender, eingereihter, laufender, abgeschlossener, fehlgeschlagener und abgelehnter Einträge.
• GET /v1/batches/:id/items listet die Einträge in der Reihenfolge des Sendens, und include=response fügt jedes fertige Ergebnis hinzu.
• Die aktiven Aufgaben pro Plan betragen jetzt Basic 25, Pro 150, Scale 500 und Max 1.000 (zuvor 10, 25, 50 und 100). Free bleibt bei 2.
• GET /v1/capabilities listet je Engine die Eingabefelder, den Credit-Preis und die Länderregeln. Ein API-Schlüssel ist nicht nötig.

So funktioniert es

Der Batch hält Ihre Einträge und startet sie als Aufgaben im Rahmen des Limits aktiver Aufgaben Ihres Plans. Einträge, die warten müssen, bleiben ausstehend und starten von selbst, sodass Sie den Batch nur einmal senden.

Jeder Eintrag wird beim Senden nach denselben Regeln wie eine einzelne Aufgabe geprüft. Ein einziger ungültiger Eintrag lässt den ganzen Batch mit 400 ablehnen, nennt bis zu 50 Indizes und speichert nichts. Ein wiederholter idempotencyKey gibt den ersten Batch zurück. Eine optionale webhook.url erhält das Ergebnis jeder Aufgabe und ein signiertes batch.completed-Ereignis, wenn der Batch fertig ist.

Einsatzbereiche

• Verfolgen Sie einen ganzen Tag an Prompts über alle Engines mit einer Übermittlung.
• Laden Sie eine Keyword-Liste mit Tausenden Einträgen und lesen Sie die Ergebnisse seitenweise.
• Bauen Sie Auswahllisten für Engines und Länder aus /v1/capabilities.

Anfrage senden

Senden Sie ein items-Array. customId ist Ihre eigene Bezeichnung für einen Eintrag und kommt mit seinem Ergebnis zurück.

curl -X POST https://api.querying.ai/v1/batches \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "customId": "crm-chatgpt",
        "taskType": "CHATGPT",
        "payload": { "prompt": "best CRM for startups", "country": "US" }
      },
      {
        "customId": "crm-gemini",
        "taskType": "GEMINI",
        "payload": { "prompt": "best CRM for startups", "country": "US" }
      },
      {
        "customId": "crm-perplexity",
        "taskType": "PERPLEXITY",
        "payload": { "prompt": "best CRM for startups", "country": "US" }
      }
    ],
    "idempotencyKey": "daily-2026-10-09"
  }'

Antwort

Der Aufruf antwortet mit 202 und dem Batch. Die Zahlen ändern sich, während Einträge freigegeben werden und abschließen.

{
  "success": true,
  "batch": {
    "id": "…",
    "status": "OPEN",
    "total": 3,
    "counts": {
      "pending": 3,
      "queued": 0,
      "processing": 0,
      "completed": 0,
      "failed": 0,
      "rejected": 0
    },
    "idempotencyKey": "daily-2026-10-09",
    "createdAt": "…"
  }
}

Lesen Sie die Ergebnisse seitenweise in der Reihenfolge des Sendens. Jeder Eintrag zeigt Status, Aufgaben-ID und mit include=response sein Ergebnis.

curl "https://api.querying.ai/v1/batches/$BATCH_ID/items?include=response&limit=20" \
  -H "Authorization: Bearer $QUERYING_API_KEY"

Fehler

Ein Eintrag, der mit PLAN_CONCURRENCY_LIMIT, QUEUE_BACKPRESSURE oder KEY_DAILY_CREDIT_LIMIT abgelehnt wird, bleibt ausstehend, und der Batch versucht ihn erneut. Jede andere Ablehnung beendet diesen Eintrag als rejected mit dem Code in error.

VALIDATION_ERRORHTTP 400

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

PAYLOAD_TOO_LARGEHTTP 413

Der Body ist größer als 1 MiB, bei einem Batch größer als 8 MiB.

KEY_SCOPE_DENIEDHTTP 403

Die Engine liegt außerhalb der Erlaubten Engines des Schlüssels. Nutzen Sie einen anderen Schlüssel oder ergänzen Sie die Engine unter Schlüssel verwalten.

INSUFFICIENT_CREDITSHTTP 402

Das Guthaben liegt unter dem Preis der Aufgabe. Laden Sie Credits auf oder wechseln Sie den Plan und senden Sie erneut.

Preis

Jeder Eintrag kostet die Credits einer einzelnen Aufgabe der jeweiligen Engine. Die Limits der Pläne stehen auf https://querying.ai/pricing .