레이트 제한

각 API 키에는 요금제에서 도출된 지속적인 초당 요청 수 제한이 있습니다(Free 1 req/s → Max 60 req/s — 요금 참조). 제한은 토큰 버킷으로 적용됩니다: 분당 용량까지의 버스트는 허용되며, 이후 요청은 지속 레이트로 평활화됩니다.

제한될 때

{ "error": "rate_limited", "retry_after_ms": 850 }

• HTTP 429, error: "rate_limited".
• retry_after_ms 는 재시도 전에 기다려야 할 최소 시간을 알려줍니다.
• 모든 응답의 x-ratelimit-remaining 헤더는 이번 분에 남은 요청 수를 보고합니다.

동시성

초당 레이트 외에도 진행 중인 요청 수에 상한이 있습니다. 많은 요청을 한 번에 발행하면 다음을 볼 수 있습니다:

• 409 request_in_progress — 동일한 멱등 요청이 이미 실행 중입니다.
• 503 too_many_concurrent_requests — 진행 중인 동시 요청이 너무 많습니다. 백오프 후 재시도하세요.

제한 처리

• retry_after_ms 를 준수하세요. 그렇지 않으면 지터를 적용한 지수 백오프를 사용하세요.
• 요금제 레이트에 맞춘 클라이언트 측 동시성 상한을 유지하세요.
• 공식 SDK 는 429/503 을 자동으로 재시도합니다.

팁

더 높은 레이트가 필요하신가요? 요금제를 업그레이드하거나 Enterprise 제한에 대해 문의하세요.