API 문서API 문서
요청 제한과 동시 실행
키 단위 요청 한도와 계정 단위 작업 한도
이 한도는 서비스 가용성을 보호하기 위한 것으로, 비용이 큰 처리에 들어가기 전에 적용됩니다.
| 한도 | 현재 값 |
|---|---|
| 작업 생성 | API 키당 분당 10회 요청, 모든 생성 엔드포인트 합산 |
| 인증된 조회 | API 키당 분당 120회 요청 |
| 진행 중 작업 | 계정당 queued 또는 processing 상태 8건 |
| 배치 수 | 생성·편집 작업 1건당 출력 4장까지 |
| 제한 대기 | 최대 30초 |
요청 한도나 진행 중 작업 한도를 넘기면 HTTP 429와 RATE_LIMIT_EXCEEDED가
반환됩니다. 지터를 섞은 지수 백오프를 쓰고, Retry-After가 있으면 그 값을
지키세요. 같은 논리적 요청을 재시도하는 동안에는 멱등성 키를 바꾸면 안 됩니다.
진행 중 작업 한도는 API 키를 여러 개 쓰더라도 계정 전체에 적용됩니다. 완료된 작업은 이 수에 포함되지 않습니다.
배치 수가 최대일 때, 진행 중인 생성·편집 작업 8건으로 합계 32장까지 요청할 수 있습니다. 이는 제출 가능한 용량의 한도이지, 모든 출력이 동시에 실행된다는 보장은 아닙니다.