# レート制限と同時実行

リクエスト制限、タスク制限、429 への対処。

出典：https://scifig.ai/ja/docs/api/rate-limits

## 制限

| 制限 | 値 | 適用対象 |
| --- | --- | --- |
| 作成リクエスト | 1 分あたり 20 | 各 API キー、または OAuth のクライアントとアカウントの組み合わせ。すべての `POST` エンドポイントで共通 |
| 作成リクエスト | 1 分あたり 40 | 各アカウント。すべての認証情報で共通 |
| 読み取りリクエスト | 1 分あたり 120 | 各 API キー、または OAuth のクライアントとアカウントの組み合わせ |
| 実行中のタスク | プラン別（`GET /credits` を参照） | 各アカウント。ウェブサイトと共有 |
| 1 時間あたりのタスク | 直近 1 時間あたり 200 | 各アカウント。ウェブサイトと共有 |
| ラスター変換 | 1 日あたり 200 | 各アカウント |
| 文字検出 | 15 分あたり 20 回 | 各アカウント。ウェブサイトと共有 |
| 待機時間の上限 | 30 秒 | 各リクエスト |

## 429 への対処

- 認証とスコープ検証を通過したリクエストのレスポンスには、最も厳しいリクエスト枠の `X-RateLimit-Limit`、`X-RateLimit-Remaining`、`X-RateLimit-Reset` が含まれます。`401` と `403 SCOPE_DENIED` には含まれません。`429` は秒単位の `Retry-After` を含みます。
- `429 CONCURRENCY_LIMITED` は、そのアカウントですでに多くのタスクが実行中であることを示します。完了したタスクは数えません。`429 RATE_LIMITED` の原因は以下を参照してください。
- 少なくとも `Retry-After` の時間だけ待ち、ランダムな揺らぎを加えた指数バックオフを使って、同じ `Idempotency-Key` で再試行してください。
- タスク制限はアカウント単位です。キーを増やしても実行枠は増えません。

## 429 の原因

- リクエスト数の超過：作成は認証情報ごとに 1 分 20 件、アカウントごとに 40 件、読み取りは認証情報ごとに 1 分 120 件。`Retry-After` は枠のリセットまでの時間です。`details.reason` は含まれません。
- 直近 1 時間に開始したタスク数の超過：アカウントごとに最大 200 件、ウェブサイトと共有。`Retry-After: 30`。
- 実行中タスク数の超過：`429 CONCURRENCY_LIMITED`。プラン別で、ウェブサイトと共有（`GET /credits` を参照）。`Retry-After: 30`。
- 無料の PNG・PDF・TIFF・PPTX 変換、1 日 200 回の枠を使い切りました。`details.reason = DAILY_CONVERSION_LIMIT` と、日次枠リセットまでの `Retry-After` を返します。
- アップロードの頻度超過：`details.reason = UPLOAD_RATE_LIMITED`。`POST /files` の画像・マスク、フローチャートの添付、グラフのデータに、ウェブサイトの分ごとの上限を適用します。
- 1 日のアップロード数の超過：`details.reason = UPLOAD_DAILY_LIMIT_REACHED`。フローチャートの添付とグラフのデータに、ウェブサイトの日次上限を適用します。
- 文字検出：アカウントごとに 15 分間で 20 回、ウェブサイトと共有。