할당량 및 한도

이 문서에는 Speech-to-Text에 적용되는 할당량과 시스템 한도가 나와 있습니다.

  • 할당량은 사용할 수 있는 계수 가능한 공유 리소스의 양을 지정합니다. 할당량은 Speech-to-Text와 같은 Google Cloud 서비스에서 정의합니다.
  • 시스템 한도는 변경할 수 없는 고정 값입니다.

Google Cloud는 공정성을 보장하고 리소스 사용 및 가용성의 급증을 줄이기 위해 할당량을 사용합니다. 할당량은 Google Cloud 프로젝트에서 사용할 수 있는 Google Cloud 리소스의 양을 제한합니다. 할당량은 하드웨어, 소프트웨어, 네트워크 구성요소를 포함하여 다양한 리소스 유형에 적용됩니다. 예를 들어 할당량에 따라 서비스에 대한 API 호출 수, 프로젝트에서 동시에 사용하는 부하 분산기 수, 만들 수 있는 프로젝트 수가 제한될 수 있습니다. 할당량은 서비스 과부하를 방지하여 Google Cloud 사용자 커뮤니티를 보호합니다. 할당량은 자체 Google Cloud 리소스를 관리하는 데도 도움이 됩니다.

Cloud Quotas 시스템은 다음을 수행합니다.

  • Google Cloud 제품 및 서비스 소비량 모니터링
  • 리소스 소비 제한
  • 할당량 값 변경을 요청할 수 있는 수단 제공

대부분의 경우 할당량이 허용하는 것보다 더 많은 리소스를 소비하려고 하면 시스템에서 리소스에 대한 액세스를 차단하고 수행하려는 작업이 실패합니다.

할당량은 일반적으로 Google Cloud 프로젝트 수준에서 적용됩니다. 한 프로젝트의 리소스를 사용해도 다른 프로젝트에서 사용 가능한 할당량에는 영향을 미치지 않습니다. Google Cloud 프로젝트 내에서 할당량은 모든 애플리케이션과 IP 주소에 공유됩니다.

대부분의 할당량을 조정하려면 Google Cloud 콘솔을 사용합니다. 자세한 내용은 할당량 조정 요청을 참고하세요.

Speech-to-Text 리소스에도 시스템 한도가 있습니다. 한도는 변경할 수 없습니다.

이 문서에서는 현재 Cloud Speech-to-Text 사용 시 적용되는 API 제한사항 및 사용량 한도에 관한 내용을 다룹니다. 제한사항 및 사용량 한도에 변경사항이 있으면 이 페이지에 업데이트됩니다. Google은 이와 같은 한도를 변경할 권리를 보유합니다.

콘텐츠 한도

Speech-to-Text로 전송되는 콘텐츠는 요청의 content 필드 내에서 오디오 데이터 형태로 직접 제공되거나 요청의 uri 필드에 명시된 Google Cloud Storage URI 내에서 참조됩니다. 로컬 파일을 사용해 API에 전송되는 모든 단일 요청에는 10MB의 한도가 적용됩니다. Recognize 및 LongRunningRecognize 메서드의 경우 이 한도는 전송된 요청의 크기에 적용됩니다. StreamingRecognize 메서드의 경우 10MB 한도는 초기 StreamingRecognize 요청 및 스트림의 각 개별 메시지 크기에 모두 적용됩니다. 이 한도를 초과하면 오류가 발생합니다. Google Cloud Storage 버킷에 저장된 오디오 데이터를 사용해 전송된 요청에는 크기 한도가 적용되지 않습니다.

API에는 다음과 같은 콘텐츠 크기 한도가 포함되며 변경될 수 있습니다.

콘텐츠 한도 오디오 길이
동기식 요청 최대 1분
비동기식 요청 최대 480분*
스트리밍 요청 최대 5분**

* 오디오가 1분을 초과하는 경우 uri 필드를 사용하여 Google Cloud Storage의 오디오 파일을 참조해야 합니다.
** 콘텐츠를 5분 넘게 스트리밍해야 하는 경우 지속적인 스트리밍 튜토리얼을 참조하세요.

StreamingRecognize 요청의 경우 오디오는 실시간에 가까운 속도로 전송되어야 합니다.

이러한 콘텐츠 한도를 초과하여 콘텐츠를 처리하려고 하면 오류가 발생합니다. 자세한 내용은 오류 메시지 및 문제 해결을 참조하세요.

모든 요청 내에서 요청과 관련된 구문 목록이 포함된 PhraseSet 리소스를 제공할 수도 있습니다. (이 문맥에서 한 단어는 하나의 구문으로 간주합니다.) 이러한 문맥에 적용되는 한도는 다음과 같습니다.

음성 적응 한도 값
요청당 구문 수 5,000개
요청당 총 문자 수(영문 기준) 100,000
구문당 문자 수(영문 기준) 100

요청 한도

현재 Speech-to-Text에 적용되는 API 사용량 한도는 다음과 같으며 변경될 수 있습니다.

한도 유형 사용량 한도
60초당 인식 요청 수* 900
60초당 적응 리소스 요청 수* 10
일일 처리 480시간 분량의 오디오

* 스트림 내에 여러 프레임의 StreamingRecognizeRequest 오디오를 포함하더라도, 각각의 StreamingRecognize 세션은 단일 요청으로 간주됩니다.

이러한 한도를 초과하여 오디오 처리를 요청하거나 시도할 경우 오류가 발생합니다. 자세한 내용은 오류 메시지 및 문제 해결을 참조하세요.

이러한 한도는 각각의 Speech-to-Text 개발자 프로젝트에 적용되며, 특정 개발자 프로젝트를 사용하는 모든 애플리케이션과 IP 주소 전반에 공유됩니다.