할당량 및 한도

이 문서에서는 Cloud Vision에 적용되는 할당량과 한도를 설명합니다. 할당량에 대한 자세한 내용은 가상 프라이빗 클라우드(VPC) 할당량을 참조하세요.

할당량은 하드웨어, 소프트웨어, 네트워크 구성요소를 포함하여 Google Cloud 프로젝트에서 사용할 수 있는 공유 Google Cloud 리소스의 양을 제한합니다. 따라서 할당량은 다음을 수행하는 시스템에 속합니다.

  • Google Cloud 제품 및 서비스 사용 또는 소비를 모니터링합니다.
  • 공정성 보장 및 사용량 급증 방지 등의 이유로 리소스 소비를 제한합니다.
  • 사전 정의된 제한사항을 자동으로 적용하는 구성을 유지합니다.
  • 할당량을 요청하거나 변경할 수 있는 수단을 제공합니다.

대부분의 경우 할당량이 초과되면 시스템에서 관련 Google 리소스에 대한 액세스를 즉시 차단하고 수행하려는 작업이 실패합니다. 대부분의 경우 할당량은 각 Google Cloud 프로젝트에 적용되며 해당 Google Cloud 프로젝트를 사용하는 모든 애플리케이션과 IP 주소 전반에 공유됩니다.

대부분의 할당량은 Google Cloud 콘솔을 사용해 늘리거나 줄입니다. 자세한 내용은 할당량 상향 요청을 참조하세요.

Vision 리소스에도 한도가 있습니다. 이 한도는 할당량 시스템과 관련이 없습니다. 별도로 명시되지 않는 한 한도를 변경할 수 없습니다.

할당량 유형

할당량에는 다음 3가지가 있습니다.

  1. 요청 할당량
    • 할당량은 Vision API 엔드포인트로 전송된 요청별로 계산합니다.
  2. 기능 할당량
    • 할당량은 Vision API 엔드포인트로 전송된 이미지/파일별로 계산합니다.
    • 명시적으로 지정하지 않으면 기능 이름이 프리픽스인 할당량은 일반적으로 기능 할당량입니다.
  3. 처리 중 할당량
    • 할당량은 명시적으로 지정하지 않는 한 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 Console 프로젝트에 적용되며, 같은 프로젝트를 사용하는 모든 애플리케이션과 IP 주소 전반에 공유됩니다.

Google Cloud Console에서 사용자별로 더 낮은 할당량을 설정할 수 있습니다.

할당량 상향 조정

Google Cloud Console 페이지의 할당량 페이지에서 할당량 수정을 선택하여 최댓값 한도 내에서 할당량을 수정할 수 있습니다. 최대 할당량 이상으로 상향 조정을 요청하려면 요청하고자 하는 상향 폭과 사유를 포함하여 할당량을 수정하고 업데이트를 제출하세요. 요청이 접수되면 알림이 전송됩니다. 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% 더 큼).