Les lots acceptent désormais 10 000 tâches

Un lot stocke jusqu’à 10 000 tâches et les exécute selon la limite de votre plan, et tous les plans payants exécutent maintenant plus de tâches en parallèle.

Ce que vous obtenez

• POST /v1/batches accepte jusqu’à 10 000 éléments (32 Mio), chacun avec son propre taskType et payload, et répond 202 avec le lot.
• GET /v1/batches/:id indique la progression avec le nombre d’éléments en attente, en file, en cours, terminés, échoués et rejetés.
• GET /v1/batches/:id/items liste les éléments dans l’ordre d’envoi, et include=response ajoute chaque résultat terminé.
• Les tâches actives par plan sont désormais Basic 25, Pro 150, Scale 500 et Max 1 000 (avant : 10, 25, 50 et 100). Free reste à 2.
• GET /v1/capabilities liste les champs d’entrée, le prix en crédits et la politique de pays de chaque moteur. Aucune clé API n’est nécessaire.

Fonctionnement

Le lot garde vos éléments et les lance comme tâches dans la limite de tâches actives de votre plan. Les éléments qui doivent attendre restent en attente et démarrent d’eux-mêmes : vous envoyez le lot une seule fois.

Chaque élément est vérifié à l’envoi avec les mêmes règles qu’une tâche unique. Un seul élément invalide fait rejeter tout le lot avec 400, indique jusqu’à 50 index et ne stocke rien. Renvoyer le même idempotencyKey retourne le premier lot. Un webhook.url facultatif reçoit le résultat de chaque tâche et un événement batch.completed signé à la fin du lot.

Cas d’usage

• Suivez une journée entière de prompts sur tous les moteurs en un seul envoi.
• Chargez une liste de milliers de mots-clés et lisez les résultats page par page.
• Construisez des sélecteurs de moteurs et de pays à partir de /v1/capabilities.

Envoyer la requête

Envoyez un tableau items. customId est votre propre libellé pour un élément et revient avec son résultat.

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"
  }'

Réponse

L’appel répond 202 avec le lot. Les compteurs évoluent à mesure que les éléments partent et se terminent.

{
  "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": "…"
  }
}

Lisez les résultats page par page, dans l’ordre d’envoi. Chaque élément indique son statut, l’ID de sa tâche et, avec include=response, son résultat.

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

Erreurs

Un élément refusé avec PLAN_CONCURRENCY_LIMIT, QUEUE_BACKPRESSURE ou KEY_DAILY_CREDIT_LIMIT reste en attente et le lot le retente. Tout autre refus termine cet élément en rejected, avec le code dans error.

VALIDATION_ERRORHTTP 400

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

PAYLOAD_TOO_LARGEHTTP 413

Le corps dépasse 1 Mio, ou 8 Mio pour un lot.

KEY_SCOPE_DENIEDHTTP 403

Le moteur est hors des Moteurs autorisés de la clé. Utilisez une autre clé ou ajoutez le moteur dans Gérer la clé.

INSUFFICIENT_CREDITSHTTP 402

Le solde est inférieur au prix de la tâche. Ajoutez des crédits ou changez de plan, puis renvoyez-la.

Tarif

Chaque élément coûte les crédits d’une tâche unique sur son moteur. Les limites de chaque plan figurent sur https://querying.ai/pricing .