이 문서에는 Speech-to-Text에 적용되는 할당량과 한도가 나와 있습니다.
할당량은 하드웨어, 소프트웨어, 네트워크 구성요소를 포함하여 Google Cloud 프로젝트에서 사용할 수 있는 공유 Google Cloud 리소스의 양을 제한합니다. 따라서 할당량은 다음을 수행하는 시스템에 속합니다.
- Google Cloud 제품 및 서비스 사용 또는 소비량을 모니터링합니다.
- 공정성 보장 및 사용량 급증 방지 등의 이유로 리소스 소비를 제한합니다.
- 사전 정의된 제한사항을 자동으로 적용하는 구성을 유지합니다.
- 할당량을 요청하거나 변경할 수 있는 수단을 제공합니다.
대부분의 경우 할당량이 초과되면 시스템에서 관련 Google 리소스에 대한 액세스를 즉시 차단하고 수행하려는 작업이 실패합니다. 대부분의 경우 할당량은 각 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 주소 전반에 공유됩니다.