API リファレンス
レート制限と同時実行
リクエスト制限、タスク制限、429 への対処。
制限#
| 制限 | 値 | 適用対象 |
|---|---|---|
| 作成リクエスト | 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 回、ウェブサイトと共有。