> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

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

> 各タスクの料金、クレジットの確保と請求の仕組み、429または503を返す上限。

すべてのタスクにはクレジット単位の料金があります。料金は送信時に確保され、タスクが完了すると請求され、失敗すると解放されます。同時に待機中または実行中にできるタスク数はプランで決まります。

エンジンと料金の最新の一覧は、公開のcapabilitiesエンドポイントで取得できます。APIキーは不要です。

```bash theme={"theme":"css-variables"}
curl https://api.querying.ai/v1/capabilities
```

`?taskType=GEMINI` を付けると1つのエンジンを読み取れます。`GOOGLE_AIO` などのエイリアスも受け付けます。[capabilitiesの取得](/ja/api-reference/capabilities.md)を参照してください。

## タスクごとのクレジット

| `taskType` | クレジット |
| - | - |
| `CHATGPT` | 回答ごとに1。`payload.followUps` の各エントリも1回答として数えます。 |
| `PERPLEXITY`、`BING_COPILOT`、`META_AI` | 1 |
| `GEMINI`、`GOOGLE`(`GOOGLE_AIO`)、`AIMODE`(`GOOGLE_AIMODE`)、`NAVER_AI_BRIEF`、`NAVER_AI_TAB`、`QWEN`、`DOUBAO` | 1.25 |
| `GOOGLE_SERP`、`NAVER_SERP`、`BING_SEARCH`、`REDDIT` | 1 |
| `COMMERCE_SERP` | 3 |
| `COMMERCE_PRODUCT` | 3 |
| `WEB_SCRAPE`、`WEB_MAP` | 1 |
| `WEB_CRAWL` | 返したページごとに1。送信時に `maxPages` クレジットを確保し、読めなかったページには課金しません。 |
| `KEYWORD_VOLUME` | タスクごとに3(最大100キーワード) |
| `PROMPT_RESEARCH` | 11 |
| `GEO_SCORE` | ページごとに10、文字を読んだ画像1枚ごとに5(`images.read`、最大12枚)。送信時に70を確保し、読めなかった画像には課金せず、90日以内の読み取りを再利用した画像(`images.reused`)は2です。 |
| `AI_RENDERING` ([AI Rendering](/ja/research/ai-rendering.md)) | レンダリングごとに5、文字を読んだ画像1枚ごとに5、90日以内の読み取りを再利用した画像1枚ごとに2(最大12枚)。送信時に65を確保します。更新も同じ料金です。 |
| [Product Lookup](/ja/research/product-lookup.md#料金)の質問 | 商品（商品と各競合商品）ごとに10、ショッピングプロンプトごとに5で、どのエンジンに尋ねても同じです。各質問はエンジンのタスクで、上のエンジン料金ではなく、この料金を分けた額が請求されます。 |
| Place Lookup（`POST /v1/place-lookup`） | 国の既定のエンジンすべてに尋ねる照会1件につき10。`KR` は質問ごとに1、その他の国は1.25です。エンジンを絞った照会は、送った質問の分だけかかります。[Place Lookup](/ja/research/place-lookup.md)を参照してください。 |
| `CITATION_ANALYSIS` | 使用量に応じた従量課金で、確保額が上限。下記を参照してください。 |

| 追加オプション | クレジット |
| - | - |
| `payload.include.analysis` | エンジンの料金に加えて2。`analysis.status` が `ok` の場合にのみ請求 |
| `payload.include.html` | `CHATGPT`、`PERPLEXITY`、`META_AI` では0.25。`html.status` が `ok` の場合にのみ請求。`GEMINI`、`GOOGLE`、`AIMODE` では無料。 |
| `payload.include.citationAnalysis` | 別個の `CITATION_ANALYSIS` タスク。使用量に応じて請求 |
| モニターの競合読み取り | モニターごとに30日あたり80クレジットを、その実行に分けて請求。[GEOモニタリング](/ja/monitors.md#コストとスケジュール)を参照してください。 |

料金はプランによって変わりません。変わるのは1クレジットあたりの金額です。クレジットは `1.25` のように小数点以下2桁まで持てます。

### Citation Analysisの従量課金

`CITATION_ANALYSIS` タスクは、送信時に `20 + 12 × citations + 80 × ⌈answer characters ÷ 1,000⌉` クレジットを確保します。完了時には `1 + ⌈input tokens ÷ 500⌉ + ⌈output tokens ÷ 100⌉ + 2 × source fetches` が請求され、確保額を超えることはありません。確保額の残りは解放されます。[Citation Analysis](/ja/research/citation-analysis.md)を参照してください。

## 確保、請求、解放

**1. 送信: 確保**

タスクの料金(`WEB_CRAWL`、`GEO_SCORE`、`CITATION_ANALYSIS` は最大額)が、利用可能な残高から確保分に移ります。残高で賄えない場合、送信は `402 INSUFFICIENT_CREDITS` を返します。送信のレスポンスの `credits` は `0` です。

**2. 完了: 請求**

確保分から請求されます。終了後のポーリングとWebhookでは `creditsCharged` に表示されます。

**3. 失敗: 解放**

確保分は残高に戻ります。失敗したタスクの料金は `0` です。

新しいアカウントには登録時に500クレジットが付与されます。

## 残高を確認する

`GET /v1/credits` はアカウントのクレジットを返します。取得にクレジットはかからないため、バッチを送る前に毎回確認できます。[クレジット残高](/ja/api-reference/credits.md)を参照してください。

```bash theme={"theme":"css-variables"}
curl https://api.querying.ai/v1/credits \
  -H "Authorization: Bearer $QUERYING_API_KEY"
```

```json theme={"theme":"css-variables"}
{
  "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か月有効で、更新後も繰り越され、プランのクレジットを使い切ってから使われます。

サブアカウントはあなたのクレジットを使うため、サブアカウントのキーには `403 SUB_ACCOUNT_FORBIDDEN` が返ります。[サブアカウント](/ja/sub-accounts.md)を参照してください。

## 使用量を確認する

`GET /v1/usage` は、UTCの日付範囲でアカウントに請求されたクレジットを、日・エンジン・APIキー別に分けて返します。取得にクレジットはかかりません。[クレジット使用量](/ja/api-reference/usage.md)を参照してください。

```bash theme={"theme":"css-variables"}
curl "https://api.querying.ai/v1/usage?from=2026-10-01&to=2026-10-20&groupBy=engine" \
  -H "Authorization: Bearer $QUERYING_API_KEY"
```

```json theme={"theme":"css-variables"}
{
  "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` です。モニターの競合読み取りはタスクなしで請求されるため、残高は減りますが使用量には現れません。
* [サブアカウント](/ja/sub-accounts.md)のタスクもあなたの使用量に含まれ、`apiKey.subAccountId` がキーを持つサブアカウントを示します。サブアカウント1つは [`GET /v1/sub-accounts/{id}/usage`](/ja/api-reference/sub-accounts/get-usage) で読みます。サブアカウントのキーには `403 SUB_ACCOUNT_FORBIDDEN` が返ります。

## キューを確認する

`GET /v1/async/status` は、待機中と実行中のタスクを、それらが数えられる同時実行数の上限とあわせて返します。取得にクレジットはかかりません。[キューの状態](/ja/api-reference/queue-status.md)を参照してください。

```bash theme={"theme":"css-variables"}
curl https://api.querying.ai/v1/async/status \
  -H "Authorization: Bearer $QUERYING_API_KEY"
```

```json theme={"theme":"css-variables"}
{
  "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`](/ja/api-reference/stats) で読みます。

## プラン

| プラン | 月額 | 月間クレジット | 同時実行タスク数 |
| - | - | - | - |
| Free | \$0 | 登録時に500 | 2 |
| Basic | \$20 | 8,000 | 50 |
| Pro | \$200 | 170,000 | 200 |
| Scale | \$500 | 480,000 | 500 |
| Max | \$1,000 | 1,000,000 | 1,000 |

プランの比較は[料金ページ](https://querying.ai/ja/pricing)をご覧ください。

### プランの同時実行数

同時実行の上限は、アカウントの `QUEUED` と `PROCESSING` のタスクを合わせて数えます。送信の速さを制限するものではありません。上限を超える送信は、`details.limit`、`details.active`、`Retry-After` 付きの `429 PLAN_CONCURRENCY_LIMIT` を返します。契約によってアカウントに別の上限を設定でき、親アカウントは[サブアカウント](/ja/sub-accounts.md)に上限を設定できます。

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

| 上限 | 設定場所 | 到達時 |
| - | - | - |
| APIキーの1日のクレジット上限 | [ダッシュボード](https://querying.ai/dashboard/keys)のキー管理。0.01〜20,000,000クレジット | 次のUTC午前0時まで `429 KEY_DAILY_CREDIT_LIMIT`。`Retry-After` はそれまでの秒数です。 |
| サブアカウントの `monthlyCreditLimit` | 親アカウント。[サブアカウント](/ja/sub-accounts.md)を参照してください。 | `429 SUB_ACCOUNT_CREDIT_LIMIT` |

キーの1日の上限はタスクに必要な確保額で数えるため、`used + price` が上限を超える場合にタスクは拒否されます。

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

| 上限 | レスポンス |
| - | - |
| `/v1/*` で `Authorization` の認証情報ごとに毎分1,200リクエスト | エッジからの `429` |
| 送信元IPごとに毎分6,000リクエスト | エッジからの `429` |
| 1つのエンジンのキューが満杯 | `Retry-After` 付きの `503 QUEUE_BACKPRESSURE` |
| 受け付けが飽和 | `Retry-After` 付きの `503 SERVER_OVERLOADED` |
| 全体のタスクキューが満杯 | `Retry-After` 付きの `503 SERVER_OVERLOADED` |
| 1つのエンジンが一時的にタスクを受け付けていない | `Retry-After` 付きの `503 ENGINE_UNAVAILABLE` |

エッジの `429` はAPIより手前で返るため、JSONのエラーエンベロープも `Retry-After` も付きません。受け取ったら指数的に間隔を空けてください。タスク送信エンドポイントからの `429` と `503` には、秒単位の `Retry-After` ヘッダーが付きます。コードと再試行の方針は[エラー](/ja/concepts/errors.md)に記載しています。

## 大量の送信のペース配分

**1. ループせずバッチにする**

500項目の `POST /v1/async/task/batch` 1回は、エッジの上限に対して1リクエストです。同時実行の上限を超える量には `POST /v1/batches` を使ってください。サーバーが空きができ次第項目を投入します。[バッチとグリッド](/ja/concepts/bulk-submission.md)を参照してください。

**2. Retry-After に従う**

拒否されたタスクを再送信する前に、`Retry-After` の秒数だけ待ってください。同じ `idempotencyKey` を再利用すれば、再試行で重複が作られることはありません。

**3. 依存する処理を順に送る**

実行順序は保証されません。結果に依存する処理は、タスクが完了するのを待ってから送信してください。

**4. 件数を監視する**

[`GET /v1/async/status`](/ja/api-reference/queue-status) は待機中と実行中のタスクをプランの上限とあわせて返すため、上限内に収めるのに使えます。[`GET /stats`](/ja/api-reference/stats) は過去24時間に終了したタスク数を加えて返します。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.