공통 규칙

요청 한도

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 후에 재시도하세요.