Os lotes agora comportam 10.000 tarefas

Um lote guarda até 10.000 tarefas e as executa conforme o limite do seu plano, e todos os planos pagos agora executam mais tarefas ao mesmo tempo.

O que você recebe

• POST /v1/batches aceita até 10.000 itens (32 MiB), cada um com seu próprio taskType e payload, e responde 202 com o lote.
• GET /v1/batches/:id informa o progresso com a contagem de itens pendentes, na fila, em processamento, concluídos, com falha e rejeitados.
• GET /v1/batches/:id/items lista os itens na ordem de envio, e include=response acrescenta cada resultado concluído.
• As tarefas ativas por plano agora são Basic 25, Pro 150, Scale 500 e Max 1.000 (antes 10, 25, 50 e 100). O Free fica em 2.
• GET /v1/capabilities lista os campos de entrada, o preço em créditos e a política de países de cada mecanismo. Não precisa de chave de API.

Como funciona

O lote guarda seus itens e os inicia como tarefas dentro do limite de tarefas ativas do seu plano. Os itens que precisam esperar ficam pendentes e começam sozinhos, então você envia o lote uma única vez.

Cada item é validado no envio com as mesmas regras de uma tarefa individual. Um único item inválido faz o lote inteiro ser rejeitado com 400, indica até 50 índices e não guarda nada. Repetir um idempotencyKey devolve o primeiro lote. Um webhook.url opcional recebe o resultado de cada tarefa e um evento batch.completed assinado quando o lote termina.

Onde ajuda

• Acompanhe um dia inteiro de prompts em todos os mecanismos com um único envio.
• Carregue uma lista de milhares de palavras-chave e leia os resultados página a página.
• Monte seletores de mecanismos e países a partir de /v1/capabilities.

Envie a requisição

Envie um array items. customId é o seu próprio rótulo para um item e volta junto com o resultado.

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

Resposta

A chamada responde 202 com o lote. As contagens mudam conforme os itens são liberados e concluídos.

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

Leia os resultados página a página, na ordem de envio. Cada item mostra seu status, o ID da tarefa e, com include=response, o resultado.

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

Erros

Um item recusado com PLAN_CONCURRENCY_LIMIT, QUEUE_BACKPRESSURE ou KEY_DAILY_CREDIT_LIMIT continua pendente e o lote tenta de novo. Qualquer outra recusa encerra esse item como rejected, com o código em error.

VALIDATION_ERRORHTTP 400

Falta um campo ou o valor está fora do intervalo. details indica o campo.

PAYLOAD_TOO_LARGEHTTP 413

O corpo passa de 1 MiB, ou de 8 MiB num lote.

KEY_SCOPE_DENIEDHTTP 403

O mecanismo está fora dos Mecanismos permitidos da chave. Use outra chave ou adicione o mecanismo em Gerenciar chave.

INSUFFICIENT_CREDITSHTTP 402

O saldo é menor que o preço da tarefa. Adicione créditos ou mude de plano e envie de novo.

Preço

Cada item custa os créditos de uma tarefa individual no seu mecanismo. Os limites de cada plano estão em https://querying.ai/pricing .