クレジットと上限: 料金、確保、同時実行数、レート制限

curl https://api.querying.ai/v1/capabilities

​

タスクごとのクレジット

​

Citation Analysisの従量課金

​

確保、請求、解放

​

残高を確認する

curl https://api.querying.ai/v1/credits \
  -H "Authorization: Bearer $QUERYING_API_KEY"

{
  "success": true,
  "remaining": 1879939,
  "perCycle": 1000000,
  "cycleResetsAt": "2026-11-14T07:37:57.000Z",
  "reserved": 61,
  "plan": "max",
  "topUpBalance": { "credits": 1000000, "nextExpiresAt": "2027-01-19T10:01:57.000Z", "nextCredits": 1000000 }
}

• remaining は今使えるクレジットです。送信済みのタスクの料金は reserved に確保されているので、改めて差し引かないでください。
• perCycle はプランがサイクルごとに付与するクレジット、cycleResetsAt は現在のサイクルが終わる日時です。有効なプランがない場合はどちらも null です。
• topUpBalance は remaining に含まれる追加クレジットと、そのうち次に失効する日時と量を示します。追加クレジットがない場合は null です。追加クレジットは購入から3か月有効で、更新後も繰り越され、プランのクレジットを使い切ってから使われます。

​

使用量を確認する

curl "https://api.querying.ai/v1/usage?from=2026-10-01&to=2026-10-20&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 と to はUTCの日付で、両方の日を含みます。既定値は今月(UTC)の初日と今日で、範囲は最大366日です。
• groupBy は day、engine、key をカンマ区切りで受け付け、既定値は day,engine です。行には選んだ分け方のフィールドが入り、請求のない組み合わせの行はありません。先頭の credits と tasks は全行の合計です。
• groupBy=key はクレジットを使った主体を示します。APIキーで送ったタスクは "source": "api" で、キーの id、keyPrefix、name、subAccountId を持つ apiKey が付きます。APIキーを使わない消費は source が monitor(モニターの実行)、playground、dashboard のいずれかで、apiKey は null です。
• 使用量はタスクに請求されたクレジットの合計で、失敗したタスクは 0 です。モニターの競合読み取りはタスクなしで請求されるため、残高は減りますが使用量には現れません。
• サブアカウントのタスクもあなたの使用量に含まれ、apiKey.subAccountId がキーを持つサブアカウントを示します。サブアカウント1つは GET /v1/sub-accounts/{id}/usage で読みます。サブアカウントのキーには 403 SUB_ACCOUNT_FORBIDDEN が返ります。

​

キューを確認する

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

• concurrency.used は queuedTasks と processingTasks の合計で、プランの同時実行数の上限が合わせて数える2つの値です。max がその上限なので、max - used が新しいタスクを入れられる余裕です。
• priorityBreakdown は、待機中のタスクを送信時の priority ごとに、値の大きい順に並べます。
• 件数には、上限を共有するサブアカウントのタスクも含まれます。サブアカウントのキーには 403 SUB_ACCOUNT_FORBIDDEN が返り、自分のタスク件数は GET /stats で読みます。

​

プラン

​

プランの同時実行数

​

キーとサブアカウントの上限

​

リクエストレートとバックプレッシャー

​

大量の送信のペース配分