속도 제한

속도 제한은 API를 남용으로부터 보호하고 모든 고객에게 공정한 사용을 보장합니다. 제한은 요금제에 따라 다릅니다.

요금제별 제한

모든 API 응답에는 헤더에 속도 제한 정보가 포함됩니다.

속도 제한을 초과하면 API가 429 Too Many Requests 응답을 반환합니다. 이를 원활하게 처리하려면:

429 Too Many Requests

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Retry after 30 seconds."
  }
}

요금제

요청/분

크레딧/월

무료

1,000

종량제

구매 기준

프로젝트

7,000

부트스트랩

28,000

스타트업

85,000

성장

200,000

헤더

설명

X-RateLimit-Limit

요금제별 분당 최대 요청 수

X-RateLimit-Remaining

현재 윈도우에서 남은 요청 수

X-RateLimit-Reset

속도 제한이 재설정되는 Unix 타임스탬프

429 오류 처리

속도 제한을 초과하면 API가 429 Too Many Requests 응답을 반환합니다. 이를 원활하게 처리하려면:

X-RateLimit-Reset 헤더를 확인하여 재시도 가능 시점을 확인하세요.

재시도 로직에 지수 백오프를 구현하세요.

분당 제한을 초과하지 않도록 요청을 대기열에 넣으세요.

지속적으로 제한에 도달하면 요금제 업그레이드를 고려하세요.

429 Too Many Requests

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Retry after 30 seconds."
  }
}