할당량 및 한도

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

필요한 경우 할당량 상향 조정을 요청할 수 있습니다. 할당량 보기 및 관리에 대한 자세한 내용은 Cloud 할당량 페이지를 참조하세요.

요청이 제출된 후 Google에서 추가 정보를 위해 연락할 수도 있고, 요청의 승인 또는 거부 여부를 알릴 수도 있습니다.

콘텐츠 한도

Speech-to-Text로 전송되는 콘텐츠는 요청의 content 필드 내에서 오디오 데이터 형태로 직접 제공되거나, 요청의 uri 필드에 명시된 Google Cloud Storage URI 내에서 참조됩니다.

API 콘텐츠 크기의 한도는 다음과 같으며 변경될 수 있습니다.

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

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

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

이러한 콘텐츠 한도를 초과하여 콘텐츠를 처리하려고 하면 오류가 발생합니다.

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

SpeechContext 한도
요청당 구문 수 5,000개
요청당 총 문자 수 10만 개
구문당 문자 수 100개

요청 한도

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

한도 유형 사용량 한도
60초당 요청* 900
일일 처리 480시간 분량의 오디오

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

이러한 한도를 초과하여 오디오 처리를 요청하거나 시도할 경우 오류가 발생합니다.

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