1つのバッチに1万件のタスクを入れられます

1つのバッチに最大1万件のタスクを入れるとプランの上限に合わせて処理され、すべての有料プランで同時実行数も増えました。

得られる結果

• POST /v1/batchesは最大1万件(32 MiB)の項目を受け取ります。項目ごとにtaskTypeとpayloadを持ち、202でバッチを返します。
• GET /v1/batches/:idは、待機、キュー、処理中、完了、失敗、拒否の件数で進捗を返します。
• GET /v1/batches/:id/itemsは項目を送信順に返し、include=responseを付けると完了した結果も含まれます。
• プランごとの同時実行タスク数はBasic 25、Pro 150、Scale 500、Max 1,000件になりました(以前は10、25、50、100件)。Freeは2件です。
• GET /v1/capabilitiesは、エンジンごとの入力フィールド、クレジット価格、国のポリシーを返します。APIキーは不要です。

仕組み

バッチは項目を保管し、プランの同時実行上限の範囲でタスクとして開始します。待つ必要のある項目は待機のまま残り、自動で開始されるため、バッチは1回送るだけです。

項目は送信時に、単一タスクと同じルールで検証されます。無効な項目が1件でもあるとバッチ全体が400で拒否され、項目番号が最大50件示され、何も保存されません。同じidempotencyKeyで再送すると、最初のバッチが返ります。webhook.urlを指定すると、各タスクの結果と、バッチ完了時の署名付きbatch.completedイベントが1回届きます。

活用例

• 1日分の質問すべてを、1回の送信で全エンジンに対して追跡できます。
• 数千件のキーワードリストを登録し、結果をページ単位で読めます。
• /v1/capabilitiesからエンジンと国の選択肢を作れます。

リクエストを送る

items配列を送ります。customIdは項目に付ける独自のラベルで、結果にそのまま戻ります。

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

レスポンス

呼び出すと202でバッチを返します。項目が出ていき完了するたびに件数が変わります。

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

結果は送信順にページ単位で読めます。各項目にステータスとタスクIDが入り、include=responseを付けると結果も含まれます。

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

エラー

PLAN_CONCURRENCY_LIMIT、QUEUE_BACKPRESSURE、KEY_DAILY_CREDIT_LIMITで拒否された項目は待機のまま残り、バッチが再試行します。それ以外の拒否は、その項目をrejectedで終え、errorにコードを入れます。

VALIDATION_ERRORHTTP 400

フィールドが欠けているか、範囲外の値です。details に該当するフィールドが入ります。

PAYLOAD_TOO_LARGEHTTP 413

本文が 1 MiB を超えています。バッチは 8 MiB まで受け付けます。

KEY_SCOPE_DENIEDHTTP 403

キーの「許可するエンジン」の対象外のエンジンです。別のキーを使うか、「キーを管理」でエンジンを追加してください。

INSUFFICIENT_CREDITSHTTP 402

残高がタスクの料金を下回っています。クレジットを追加するかプランを上げてから、もう一度送ってください。

料金

項目ごとに、そのエンジンの単一タスクと同じクレジットがかかります。プランごとの上限は https://querying.ai/pricing に掲載しています。