API 참조 문서
호출 제한 및 동시 실행
요청 제한, 작업 제한 및 429 대처 방법.
제한#
| 제한 | 값 | 적용 대상 |
|---|---|---|
| 생성 요청 | 분당 20회 | 각 API 키 또는 OAuth 클라이언트와 계정의 조합. 모든 POST 엔드포인트에 공통 적용 |
| 생성 요청 | 분당 40회 | 각 계정, 모든 인증 정보에 공통 적용 |
| 조회 요청 | 분당 120회 | 각 API 키 또는 OAuth 클라이언트와 계정의 조합 |
| 실행 중인 작업 | 요금제별(GET /credits 참조) | 각 계정, 웹사이트와 공유 |
| 시간당 작업 수 | 최근 1시간 기준 200회 | 각 계정, 웹사이트와 공유 |
| 래스터 변환 | 하루 200회 | 각 계정 |
| 텍스트 감지 | 15분마다 20회 | 각 계정, 웹사이트와 공유 |
| 대기 시간 제한 | 30초 | 각 요청 |
429 대처 방법#
- 인증과 범위 검사를 통과한 요청의 응답에는 가장 엄격한 요청 제한 구간의
X-RateLimit-Limit,X-RateLimit-Remaining및X-RateLimit-Reset이 포함됩니다.401과403 SCOPE_DENIED에는 포함되지 않습니다.429에는 초 단위의Retry-After가 포함됩니다. 429 CONCURRENCY_LIMITED는 해당 계정에 이미 너무 많은 작업이 실행 중임을 뜻합니다. 완료된 작업은 집계되지 않습니다.429 RATE_LIMITED의 원인은 아래에 나열되어 있습니다.- 최소한
Retry-After만큼 기다린 뒤 무작위 지연을 더한 지수 백오프를 적용하고, 같은Idempotency-Key로 재시도하세요. - 작업 한도는 계정 단위입니다. 키를 늘려도 실행 용량이 늘어나지 않습니다.
429 발생 원인#
- 요청 수 초과: 생성은 인증 정보별 분당 20건, 계정별 40건, 조회는 인증 정보별 분당 120건입니다.
Retry-After는 제한 구간 초기화까지의 시간이며,details.reason은 없습니다. - 최근 1시간 동안 시작한 작업 수 초과: 계정별 최대 200건, 웹사이트와 공유.
Retry-After: 30. - 실행 중인 작업 수 초과:
429 CONCURRENCY_LIMITED. 요금제별 한도를 웹사이트와 공유(GET /credits참조).Retry-After: 30. - 무료 PNG, PDF, TIFF 및 PPTX 변환의 일일 200회 한도를 소진했습니다.
details.reason = DAILY_CONVERSION_LIMIT와 일일 제한 구간 초기화까지의Retry-After를 반환합니다. - 업로드 빈도 초과:
details.reason = UPLOAD_RATE_LIMITED.POST /files의 이미지 및 마스크, 순서도 첨부 파일, 그래프 데이터에 웹사이트의 분당 업로드 한도를 적용합니다. - 일일 업로드 수 초과:
details.reason = UPLOAD_DAILY_LIMIT_REACHED. 순서도 첨부 파일과 그래프 데이터에 웹사이트의 일일 업로드 한도를 적용합니다. - 텍스트 감지: 계정별 15분당 20회, 웹사이트와 공유.