레이트 제한
공유 토큰 버킷, 응답 헤더, 429 처리 방법.
공개 API의 기본 보호 임계값은 계정당 10초에 1,000회(지속 약 100 RPS)입니다. 정상적인 유료 생성을 제한하는 낮은 할당량이 아니라 악용과 폭주 클라이언트를 막는 높은 수준의 안전장치입니다. 키를 더 만들어도 허용량은 늘지 않습니다.
X-RateLimit-Limit: 20
X-RateLimit-Remaining: 7
Retry-After: 2공유 토큰 버킷
모든 /api/v1 엔드포인트는 하나의 open_api 버킷을 사용합니다. 용량은 1,000이고 초당 약 100토큰이 보충됩니다. upload-url에는 이 제한에 더해 10초당 1,000회의 별도 보호 한도가 적용됩니다. usage에는 훨씬 더 엄격한 분당 30회의 별도 한도가 적용되며, 레이트 제한 판정을 할 수 없을 때도 통과시키지 않고 항상 429를 반환합니다.
응답 헤더
X-RateLimit-Limit와 X-RateLimit-Remaining을 확인하고 HTTP 429에서는 Retry-After의 초 단위 값을 따르세요. 한도를 넘은 요청은 대기열에 들어가지 않고 즉시 거부됩니다.
동시 실행과는 별개
레이트 제한은 API 제출 빈도를 제어하며 실행 중 작업 수를 제한하지 않습니다. 잔액, 지출 한도, 서비스 처리 용량 문제는 각각 40201, 40202, 50301입니다. Webhook을 사용하면 폴링이 버킷을 소모하는 일을 줄일 수 있습니다.
전체 필드 정의는 OpenAPI 3.1 사양을 확인하세요.