共通ルール
リクエスト上限
Callabo APIは、Fixed Window方式でリクエスト量を制御します。ユーザーまたはワークスペースごとに固定時間枠内のリクエスト数を集計し、新しい時間枠が始まるとカウントをリセットします。時間枠の終了前に上限へ達すると、次の時間枠まで429 Too Many Requestsを返します。
ユーザーリクエスト上限
ワークスペース範囲を持たない公開 API に適用されるユーザー単位のリクエスト上限です。
| 型 | 上限 |
|---|---|
| ユーザースコープAPI | 60秒あたり100回 |
| MCP | 60秒あたり100回 |
ワークスペースリクエスト上限
現在のサブスクリプションプランに応じて適用されるリクエスト上限です。
| ティア | プラン | 上限 |
|---|---|---|
ティア1・基本 無料プランに適用されるワークスペース単位のリクエスト上限です。 | free | 60秒あたり100回 |
ティア2・個人 パーソナルおよびプラスプランに適用されるワークスペース単位のリクエスト上限です。 | personalplus | 60秒あたり300回 |
ティア3・チーム・プロ チームおよびプロプランに適用されるワークスペース単位のリクエスト上限です。 | teampro | 60秒あたり600回 |
ティア4・ビジネス ビジネスプランに適用されるワークスペース単位のリクエスト上限です。 | business | 60秒あたり3,000回 |
429レスポンスと再試行
リクエスト上限超過
レスポンス本文
typestring許可されたリクエスト上限を超えたことを示すエラー種別です。data必須V2RateLimitExceededErrorDataエラーに関する追加情報です。scope必須"workspace" | "user" | "mcp"リクエスト上限が適用された単位です。retry_after_seconds必須integer再リクエスト可能になるまでの残り時間（秒）です。
{
"type": "RATE_LIMIT_EXCEEDED",
"data": {
"scope": "workspace",
"retry_after_seconds": 1
}
}429レスポンス本文のdata.retry_after_seconds後に再試行してください。