レート制限と同時実行性

現在のデフォルトは、IP ごとに 180 リクエスト/分、キーごとに 60 リクエスト、アカウントごとに 90 リクエストです。 IP 制限は認証されたリクエストにも適用されます。 1 つのアカウントのキーはアカウントのレート制限を共有します。アカウントは最大 5 つのデータ リクエストを同時に実行でき、各キーには設定された max_concurrent_requests 制限もあります。本文は 256 KB、ページは 50 アイテムに制限されます。

1 日あたりの許容量は、1 日に成功する REST データ呼び出しに上限を設けます。レート制限は 1 分以内のリクエストを制限します。同時実行制限リクエストはまだ実行中です。検証では毎日のデータ通話は使用されませんが、レートは制限されています。制限を下げたり、別のキーを作成したりしても、アカウントの 1 日あたりの許容量は回避されません。シリアルリクエストにより同時実行性は低下しますが、1 日あたりの許容量は増加しません。

REST データ呼び出しが 10 回に達すると、HTTP 429 と API_DAILY_LIMIT_REACHED を返します。Asia/Shanghai の翌 00:00 までお待ちください。キーの作成やローテーションでは枠はリセットされません。

RATE_LIMITED では Retry-After に従って間隔を空けて再試行してください。有効なキー、権限、レート、同時実行数、アカウントの制限は引き続き有効です。

HTTP 429 だけではなく、error.code を使用して回復パスを選択してください。 RateLimit-Limit、RateLimit-Remaining、および RateLimit-Reset は、短いレート ウィンドウを表します。リセットは、毎日のリセット時間ではなく、秒単位の Unix タイムスタンプです。レート ウィンドウが枯渇すると、秒単位で Retry-After が供給されます。 concurrency または daily-allowance 429 応答では省略される場合があります。毎日の使用量については daily_usage を読み取り、1 日あたりの制限エラーについては error.details.daily_usage を読み取ります。

成功した REST データリクエストは、空の結果やキャッシュへのヒットも含めて 1 回と数えます。同じ Idempotency-Key とパラメーターで再試行すると元の結果を返し、追加の回数を消費しません。失敗したリクエストと 304 応答は日次枠を消費しません。

RATE_LIMITED では Retry-After に従って間隔を空けて再試行してください。有効なキー、権限、レート、同時実行数、アカウントの制限は引き続き有効です。

RATE_LIMITED の場合は、まず Retry-After を待ちます。存在しない場合は、同時実行性を減らし、小さなランダム遅延と再試行上限を備えた指数バックオフを使用します。たとえば、停止してリクエスト ID を記録する前に、1 秒、2 秒、4 秒待ってください。 API_DAILY_LIMIT_REACHED を毎秒再試行しないでください。毎日リセットされるまで待ちます。 401、403、または無効なリクエストを再試行する前に、認証、権限、またはパラメータを修正してください。

同じ REST データ操作を再試行するときは、冪等性キーとパラメータを変更しないでください。新しい論理演算用に新しいキーを生成します。キーの再利用中にパラメータを変更すると、IDEMPOTENCY_CONFLICT が発生します。異なるページを異なる操作として扱います。再試行可能な 5xx 応答には、制限されたバックオフも必要です。

1 つのアカウントの 2 つのキーがそれぞれ 5 回のデータ呼び出しを完了すると、直前にリクエストが行われなかったとしても、1 日あたりの共有 REST 呼び出し 10 回の許容量が使い果たされます。 Web サイトには 10 回の検索許可が別途あります。 MCP は 1 日あたりの許容量を使用しませんが、同時に MCP リクエストが多すぎると RATE_LIMITED がトリガーされる可能性があります。