이 문서에서는 Cloud Vision에 적용되는 할당량 및 시스템 한도를 설명합니다. 할당량은 사용할 수 있고 계수 가능한 공유 리소스의 양을 지정하며 Cloud Vision과 같은 Google Cloud 서비스에서 정의합니다. 시스템 한도는 변경할 수 없는 고정 값입니다.
Google Cloud는 공정성을 보장하고 리소스 사용 및 가용성의 급증을 줄이기 위해 할당량을 사용합니다. 할당량은 Google Cloud 프로젝트에서 사용할 수 있는 Google Cloud 리소스의 양을 제한합니다. 할당량은 하드웨어, 소프트웨어, 네트워크 구성요소를 포함하여 다양한 리소스 유형에 적용됩니다. 예를 들어 할당량에 따라 서비스에 대한 API 호출 수, 프로젝트에서 동시에 사용하는 부하 분산기 수, 만들 수 있는 프로젝트 수가 제한될 수 있습니다. 할당량은 서비스 과부하를 방지하여 Google Cloud 사용자 커뮤니티를 보호합니다. 할당량은 자체 Google Cloud 리소스를 관리하는 데도 도움이 됩니다.
Cloud Quotas 시스템은 다음을 수행합니다.
- Google Cloud 제품 및 서비스 소비량 모니터링
- 리소스 소비 제한
- 할당량 값 변경을 요청할 수 있는 수단 제공
대부분의 경우 할당량이 허용하는 것보다 더 많은 리소스를 소비하려고 하면 시스템에서 리소스에 대한 액세스를 차단하고 수행하려는 작업이 실패합니다.
할당량은 일반적으로 Google Cloud 프로젝트 수준에서 적용됩니다. 한 프로젝트의 리소스를 사용해도 다른 프로젝트에서 사용 가능한 할당량에는 영향을 미치지 않습니다. Google Cloud 프로젝트 내에서 할당량은 모든 애플리케이션과 IP 주소에 공유됩니다.
대부분의 할당량을 조정하려면 Google Cloud 콘솔을 사용합니다. 자세한 내용은 할당량 상향 요청을 참조하세요.
Vision 리소스에도 시스템 한도가 있습니다. 이 시스템 한도는 할당량 시스템과 관련이 없습니다. 별도로 명시되지 않는 한 시스템 한도를 변경할 수 없습니다.
할당량 유형
할당량에는 다음 3가지가 있습니다.
- 요청 할당량
- 할당량은 Vision API 엔드포인트로 전송된 요청별로 계산합니다.
- 기능 할당량
- 할당량은 Vision API 엔드포인트로 전송된 이미지/파일별로 계산합니다.
- 명시적으로 지정하지 않으면 기능 이름이 프리픽스인 할당량은 일반적으로 기능 할당량입니다.
- 처리 중 할당량
- 할당량은 명시적으로 지정하지 않는 한 Vision API에서 처리되는 이미지/파일별로 계산합니다.
- 할당량 이름의 '처리 중'으로 추정될 수 있습니다.
- 이 할당량에 따라 비동기 메서드에 대해 Vision API에서 한 번에 처리되는 최대 이미지/페이지 수가 결정됩니다. 사용자가 이 할당량보다 많은 용량을 비동기 메서드로 전송할 수 있지만 할당량을 초과하는 이미지/페이지는 즉시 처리되지 않습니다. 할당량을 초과하는 파일은 나중에 처리되도록 큐에 추가됩니다.
현재 Vision API에 적용되는 API 사용 할당량은 다음과 같으며 변경될 수 있습니다.
| Vision API 할당량 | 할당량 유형 | 값 |
|---|---|---|
| 분당 요청 수(아래에 나와 있는 요청 유형 예외) | 요청 할당량 | 1,800 |
| 분당 유명인 인식 요청 수 | 요청 할당량 | 0 |
| 분당 라벨 인식 요청 | 기능 할당량 | 1,800 |
| 분당 텍스트 인식 요청 | 기능 할당량 | 1,800 |
| 처리 중인 이미지의 비동기 이미지 주석* 수 | 처리 중 할당량 | 8,000 |
| 처리 중인 페이지의 비동기 문서 텍스트 인식† 수 | 처리 중 할당량 | 10,000 |
| * | images:asyncBatchAnnotate 요청 |
| † | files:asyncBatchAnnotate 요청, DOCUMENT_TEXT_DETECTION 기능 |
| 제품 검색 할당량 | 값 |
|---|---|
| 분당 요청 수(아래에 나와 있는 요청 유형 예외) | 1,800 |
| 일일 일괄 요청 수 | 300 |
| 분당 리소스 관리 쓰기 요청 수 | 1,200 |
| 분당 리소스 관리 요청 수 | 2,400 |
이러한 한도는 각각의 Google Cloud 콘솔 프로젝트에 적용되며, 같은 프로젝트를 사용하는 모든 애플리케이션과 IP 주소 전반에 공유됩니다.
Google Cloud 콘솔에서 사용자별로 더 낮은 할당량을 설정할 수 있습니다.
할당량 상향 조정
Google Cloud 콘솔 페이지의 할당량 페이지에서 할당량 수정을 선택하여 최댓값 한도 내에서 할당량을 수정할 수 있습니다. 최대 할당량 이상으로 상향 조정을 요청하려면 요청하고자 하는 상향 폭과 사유를 포함하여 할당량을 수정하고 업데이트를 제출하세요. 요청이 접수되면 알림이 전송됩니다. Google에서는 요청과 관련한 추가 정보를 문의할 수 있으며, 요청에 대한 검토가 완료되면 요청이 승인되었는지 여부를 알려드립니다.
일반적으로 각 할당량에는 '사용자당 프로젝트별' 및 '프로젝트별' 변수가 있으므로 설정에 맞게 적절히 변경하세요.
기능의 할당량 상향 조정을 요청하는 경우 다음 사항을 보장하기 위해 전체 요청 할당량 및 의도한 배치 크기를 고려하세요.
- 전체 요청 할당량(분당 요청 수) * 배치 크기 >= 증가한 기능 할당량
이 요구사항을 충족하지 않아도 여전히 전체 요청 할당량에 의해 제한을 받습니다.
이 문서에서는 Vision API의 현재 콘텐츠 한도 및 요청 할당량에 관한 내용을 다룹니다. 제한사항 및 사용량 한도에 변경사항이 있으면 이 페이지에 업데이트됩니다.
한도
Vision API에 적용되는 사용량 한도는 다음과 같습니다.
| 콘텐츠 한도 | 값 |
|---|---|
| 이미지 파일 크기 | 20MB |
| JSON 요청 객체 크기 | 10MB |
| PDF 파일 크기 | 1GB |
images:annotate 요청당 이미지 수 |
16 |
images:asyncBatchAnnotate 요청당 이미지 수 |
2000 |
files:annotate 요청당 페이지 수 |
5 |
files:asyncBatchAnnotate 요청당 페이지 수 |
2000 |
Base64로 인코딩된 이미지 파일의 크기가 한도를 벗어나지 않더라도 JSON 크기 한도를 초과할 수 있습니다. 한도보다 큰 이미지는 Cloud Storage 또는 공개적으로 액세스 가능한 URL에서 호스팅해야 합니다. Base64로 인코딩된 이미지 파일의 크기는 원본 이미지 파일보다 클 수 있습니다(일반적으로 약 37% 더 큼).