이 문서에는 Cloud Natural Language에 적용되는 할당량과 한도가 나와 있습니다.
할당량은 하드웨어, 소프트웨어, 네트워크 구성요소를 포함하여 Google Cloud 프로젝트에서 사용할 수 있는 공유 Google Cloud 리소스의 양을 제한합니다. 따라서 할당량은 다음을 수행하는 시스템에 속합니다.
- Google Cloud 제품 및 서비스 사용 또는 소비량을 모니터링합니다.
- 공정성 보장 및 사용량 급증 방지 등의 이유로 리소스 소비를 제한합니다.
- 사전 정의된 제한사항을 자동으로 적용하는 구성을 유지합니다.
- 할당량을 요청하거나 변경할 수 있는 수단을 제공합니다.
대부분의 경우 할당량이 초과되면 시스템에서 관련 Google 리소스에 대한 액세스를 즉시 차단하고 수행하려는 작업이 실패합니다. 대부분의 경우 할당량은 각 Google Cloud 프로젝트에 적용되며 해당 Google Cloud 프로젝트를 사용하는 모든 애플리케이션과 IP 주소 전반에 공유됩니다.
대부분의 할당량은 Google Cloud 콘솔을 사용해 늘리거나 줄입니다. 자세한 내용은 할당량 상향 요청을 참조하세요.
자연어 리소스에도 한도가 있습니다. 이 한도는 할당량 시스템과 관련이 없습니다. 별도로 명시되지 않는 한 한도를 변경할 수 없습니다.
언어 제한
Natural Language API는 현재 언어 지원에 등록된 언어만 지원합니다.
콘텐츠 할당량
Natural Language API 콘텐츠는 텍스트 문자열로 제공됩니다. Natural Language API는 이 텍스트를 일련의 토큰으로 처리하며, 이는 단어 경계와 대략 일치합니다. Natural Language API의 모든 기능(감정 분석, 항목 추출, 구문 분석)은 이러한 토큰을 제공된 텍스트 분석의 기본 요소로 사용합니다.
각 요청에 대해 콘텐츠의 크기에 따른 API 할당량은 다음과 같습니다.
| 콘텐츠 할당량 | 값 | 오버플로우 결과 |
|---|---|---|
| 텍스트 콘텐츠 | 1,000,000바이트 | API 오류 |
| 토큰 할당량 | 토큰 100,000개 | 무시됨 |
| 항목 멘션 | 5,000* | 무시됨 |
텍스트 콘텐츠 할당량을 초과하는 콘텐츠를 처리하려고 할 경우 오류가 발생합니다. 토큰의 경우 할당량을 초과하는 토큰을 처리하려고 하면 오류가 발생하지는 않지만, 할당량을 초과하는 토큰은 모두 무시됩니다.
바이트 수는 텍스트 콘텐츠 내에서 사용되는 인코딩에 따라 문자 수를 반영하지 않을 수도 있습니다.
* 항목 멘션 할당량에는 문서 내에서 반환된 멘션뿐만 아니라, 대명사를 비롯하여 해당 항목에 대한 모든 명사 참조가 포함됩니다.
이러한 대명사는 할당량에 포함되지만 mentions 필드에 직접 반환되지 않습니다.
요청 할당량
현재 Cloud Natural Language API에 적용되는 API 사용 할당량은 다음과 같으며 변경될 수 있습니다.
| 할당량 유형 | 사용 할당량 |
|---|---|
| 분당 요청 수 | 600 |
| 일일 요청 수 | 800,000 |