할당량 및 한도

Cloud Translation은 전송할 수 있는 요청 수와 요청의 콘텐츠 크기에 할당량을 적용합니다. 할당량은 예기치 않은 사용량 급증을 차단함으로써 Google Cloud 사용자 커뮤니티를 보호합니다. 할당량을 낮춰 과도한 사용을 방지하고 비용을 억제할 수도 있습니다.

할당량을 초과하면 Cloud Translation에서 403 오류를 반환합니다. 일일 할당량을 초과한 경우 Daily Limit Exceeded 오류 메시지가 표시되고 분당 할당량을 초과한 경우 User Rate Limit Exceeded 오류 메시지가 표시됩니다.

일일 할당량은 태평양 표준시 기준으로 자정에 재설정되므로 새 할당량이 반영되려면 최대 24시간이 걸릴 수 있습니다.

사용 할당량 설정

기본적으로 하루에 보낼 수 있는 문자 수는 무제한입니다. 예산이 설정되어 있으면 일일 사용량을 모니터링하고 예산 금액에 따라 할당량을 조정하는 것이 좋습니다.

Google Cloud Console 할당량 페이지를 사용하여 할당량을 수정할 수 있습니다. v2 할당량은 Cloud Translation - Basic에 적용되고 v3 할당량은 Cloud Translation - Advanced에 적용됩니다.

콘텐츠 할당량

콘텐츠 할당량은 translateText, detectLanguage, translateDocument 메서드(동기식 요청)를 통해 Cloud Translation API에 전송하는 텍스트 문자열과 문서에 적용됩니다. 공백 문자를 포함하여 Cloud Translation API에 전송되는 모든 문자가 이 할당량에 반영됩니다. Cloud Translation - Basic과 Cloud Translation - Advanced를 함께 사용하는 경우 할당량이 누적됩니다.

콘텐츠 할당량 기본값
프로젝트별 일일 v2 및 v3 일반 모델 문자 무제한
프로젝트별 분당 v2 및 v3 일반 모델 문자 6,000,000자(영문 기준)
사용자당 프로젝트별 분당 v2 및 v3 일반 모델 문자* 6,000,000자(영문 기준)
프로젝트별 분당 v3 문서 번역 페이지 수 2,400페이지
사용자당 프로젝트별 분당 v3 문서 번역 페이지 수 2,400페이지

* 사용자당 할당량은 클라이언트 애플리케이션을 사용하는 최종 사용자가 분당 요청할 수 있는 요청 수에 적용됩니다. 서비스 계정을 사용하면 서비스 계정의 ID는 할당량이 적용되는 사용자가 됩니다. Cloud Translation - Basic과 API 키를 사용하면 Cloud Translation에서 클라이언트의 IP 주소를 사용하여 이 한도를 적용합니다.

Document Translation 페이지 할당량은 Cloud Translation의 문자 할당량에 반영됩니다. 예를 들어 분당 2,400페이지까지 전송할 경우 문서의 문자 수도 6,000,000자(영문 기준)를 초과할 수 없습니다. XLSX 파일의 경우 페이지 할당량은 적용되지 않고 문자 할당량만 적용됩니다. Cloud Translation - Basic에서는 Document Translation이 지원되지 않습니다.

Cloud Translation API는 소량의 요청을 번역하는 데 최적화되어 있습니다. 요청당 권장되는 최대 길이는 5,000자(코드 포인트)입니다. 하지만 포함되는 문자 수가 많을수록 응답 지연 시간이 늘어납니다. Cloud Translation - Advanced의 단일 요청당 최대 코드 포인트 수는 30,000입니다. Cloud Translation - Basic의 최대 요청 크기는 100,000바이트입니다. 또 다른 방법은 일괄 번역을 사용하여 요청별로 더 많은 콘텐츠를 장기 실행 작업으로 전송하는 것입니다.

Cloud Translation API는 남아 있는 할당량에 상관없이 최댓값보다 큰 요청은 거부하고 400 INVALID_ARGUMENT 오류를 표시합니다.

요청 할당량

Cloud Translation은 서비스에 전송할 수 있는 요청 수에 할당량을 적용합니다.

할당량 기본값
프로젝트별 분당 지원되는 언어(v2v3 결합) 가져오기 요청 요청 600개
프로젝트별 분당 v3 요청 수 요청 6,000개
사용자당 프로젝트별 분당 v3 요청 수* 무제한
프로젝트별 일일 총 v3 일괄 번역 요청(텍스트 및 문서) 수 무제한

* 사용자당 할당량은 클라이언트 애플리케이션을 사용하는 최종 사용자가 분당 요청할 수 있는 요청 수에 적용됩니다. 서비스 계정을 사용하면 서비스 계정의 ID는 할당량이 적용되는 사용자가 됩니다. Cloud Translation - Basic과 API 키를 사용하면 Cloud Translation에서 클라이언트의 IP 주소를 사용하여 이 한도를 적용합니다.

translateText, detectLanguage, translateDocument, getSupportedLanguages 메서드를 제외한 모든 Cloud Translation - Advanced 메서드 호출에 적용됩니다.

AutoML 할당량

Cloud Translation - Advanced의 경우 AutoML 모델을 사용하여 콘텐츠를 번역할 수 있습니다. 커스텀 모델을 사용하는 경우 사용량은 별도로 설정된 할당량을 기준으로 산정됩니다. AutoML 콘텐츠 및 요청 할당량에 대한 자세한 내용은 AutoML Translation 문서를 참조하세요.

할당량 계산

Cloud Translation - Basic의 경우 콘텐츠 및 요청 할당량은 요청을 수행하는 프로젝트를 기준으로 산정되며, 이때 프로젝트는 해당 요청에 사용된 키로 판단됩니다.

Cloud Translation - Advanced의 경우 콘텐츠 할당량은 해당 요청의 모델에 연결된 프로젝트에서 확인할 수 있습니다. 요청 할당량은 해당 요청을 수행한 프로젝트에서 확인됩니다.

예를 들어 다음과 같은 텍스트 번역 요청에서 요청 할당량은 project-id-1에서 확인되며, 이는 요청이 project-id-1에서 발생하기 때문입니다. 콘텐츠 할당량은 project-id-2에서 확인되며, 이는 요청이 해당 프로젝트의 모델을 사용하기 때문입니다.

POST https://translation.googleapis.com/v3/projects/project-id-1/locations/us-central1:translateText
{
  "Model":"projects/project-id-2/locations/us-central1/models/model-id",
  "sourceLanguageCode": "en",
  "targetLanguageCode": "ru",
  "contents": ["Dr. Watson, please discard your trash."]
}

Cloud Translation - Advanced 한도

다음 표는 Cloud Translation - Advanced 한도를 설명하며 이 한도는 변경할 수 없습니다.

설명 한도
일괄 요청 하나에 포함할 수 있는 최대 파일 수 파일 100개
프로젝트의 최대 용어집 리소스 수 10,000