API 문서 · 안정성
속도 제한
RPM, 동시 실행 수 및 속도 제한 응답 헤더.
RPM은 Key 단위로 60초 고정 윈도에서 계산합니다. 상한은 Key의 RPM과 계정 RPM 중 작은 값이며, 같은 계정의 여러 Key는 각각 따로 계산됩니다. 초과하면 429 rate_limited를 반환합니다. 인증을 통과한 모든 요청에는 다음 응답 헤더가 포함됩니다.
| 응답 헤더 | 의미 |
|---|---|
X-RateLimit-Limit | 현재 윈도에서 허용되는 요청 수 |
X-RateLimit-Remaining | 현재 윈도에 남은 요청 수 |
X-RateLimit-Reset | 윈도 초기화 시각(unix 초) |
Retry-After | 429일 때만 반환, 권장 대기 시간(초). 동시 실행 한도 초과 시 10 |
동시에 진행 중인 작업 수는 Key의 동시 실행 한도와 계정의 동시 실행 한도를 모두 따릅니다. 콘솔에서 Key별로 RPM과 동시 실행 한도를 설정할 수 있으며, 더 높은 계정 한도가 필요하면 운영팀에 문의하세요.
429 응답
HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1730259012
{ "error": { "code": "rate_limited", "retryable": true, ... } }