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 - Basic과 Cloud Translation - Advanced를 함께 사용하면 할당량이 누적됩니다.
텍스트 번역의 경우 커스텀 모델 할당량은 별도로 계산되며 일반 모델 할당량에 포함되지 않습니다.
| 할당량 | 기본값 |
|---|---|
| 프로젝트당 일일 일반 모델로 전송된 문자(v2 및 v3) | 무제한 |
| 프로젝트별 분당 일반 모델로 전송되는 문자(v2 및 v3) | 6,000,000 |
| 사용자당 프로젝트별 분당 일반 모델로 전송되는 문자(v2 및 v3) | 6,000,000 |
| 프로젝트별 분당 음역을 위해 전송된 문자(v3) | 100,000개(프로젝트별 분당 할당량별 일반 모델에 전송된 문자 수도 산정) |
| 프로젝트별 분당 로마자 변환을 위해 전송된 문자(v3) | 100,000 |
| 프로젝트별 분당 커스텀 모델로 전송되는 문자(v3) | 100,000 |
| 사용자별 분당 커스텀 모델에 전송되는 문자(v3) | 프로젝트 한도까지 |
| 문서 번역의 경우 프로젝트별 분당 전송되는 페이지(v3) | 2,400 |
| 문서 번역의 경우 프로젝트별 사용자별 분당 전송되는 페이지(v3) | 2,400 |
사용자당 할당량은 클라이언트 애플리케이션을 사용하는 최종 사용자가 분당 요청할 수 있는 요청 수에 적용됩니다. 서비스 계정을 사용하면 서비스 계정의 ID는 할당량이 적용되는 사용자가 됩니다. Cloud Translation - Basic과 API 키를 사용하면 Cloud Translation에서 클라이언트의 IP 주소를 사용하여 이 한도를 적용합니다.
요청당 콘텐츠 한도
Cloud Translation API는 소량의 요청을 번역하는 데 최적화되어 있습니다. 요청당 권장되는 최대 길이는 5,000자(코드 포인트)입니다. 하지만 포함되는 문자 수가 많을수록 응답 지연 시간이 늘어납니다. Cloud Translation - Advanced의 단일 요청당 최대 코드 포인트 수는 30,000입니다. Cloud Translation - Basic의 최대 요청 크기는 100,000바이트입니다. 또 다른 방법은 일괄 번역을 사용하여 요청별로 더 많은 콘텐츠를 장기 실행 작업으로 전송하는 것입니다.
Cloud Translation API는 남아 있는 할당량에 상관없이 최댓값보다 큰 요청은 거부하고 400 INVALID_ARGUMENT 오류를 표시합니다.
요청 할당량
Cloud Translation은 서비스에 전송할 수 있는 요청 수에 할당량을 적용합니다. 이 할당량은 자체 요청 또는 콘텐츠 할당량이 있는 translateDocument 및 getSupportedLanguages 메서드를 제외한 모든 Cloud Translation 메서드 호출에 적용됩니다.
커스텀 모델 할당량은 별도로 계산되며 다른 v3 요청 할당량에 포함되지 않습니다.
| 할당량 | 기본값 |
|---|---|
| 프로젝트별 분당 지원되는 언어(v2 및 v3 결합) 가져오기 요청 | 600 |
| 프로젝트별 분당 v2 요청 수 | 300,000 |
| 사용자별 프로젝트별 분당 v2 요청 수 | v2 프로젝트 한도까지 |
| 프로젝트별 분당 v3 요청 수 | 6000 |
| 프로젝트별 분당 v3 로마자 변환 요청 수 | 6000 |
| 사용자별 프로젝트별 분당 v3 요청 수 | v3 프로젝트 한도까지 |
| 일일 프로젝트별 v3 일괄 번역 요청(텍스트 및 문서) | 무제한 |
| 프로젝트별 일일 v3 커스텀 모델 번역 요청 수 | 무제한 |
| 프로젝트별 분당 v3 커스텀 모델 번역 요청 수 | 600 |
| 프로젝트별 일일 v3 커스텀 모델 일괄 번역 요청 수 | 무제한 |
| 프로젝트별 분당 v3 모델 생성 요청 수 | 10 |
| 프로젝트당 v3 동시 모델 생성 요청 수 | 2 |
사용자당 할당량은 클라이언트 애플리케이션을 사용하는 최종 사용자가 분당 요청할 수 있는 요청 수에 적용됩니다. 서비스 계정을 사용하면 서비스 계정의 ID는 할당량이 적용되는 사용자가 됩니다. Cloud Translation - Basic과 API 키를 사용하면 Cloud Translation에서 클라이언트의 IP 주소를 사용하여 이 한도를 적용합니다.
할당량 계산
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 |
적응형 번역
| 설명 | 한도 |
|---|---|
| 가져올 수 있는 최대 세그먼트 쌍 수 | 10,000(Google Cloud 콘솔) 30,000(API) |
| 요청당 보낼 수 있는 최대 문자 수 | 3,000 |
| 요청당 적응형 번역의 최대 출력 문자 수 | 언어에 대해 3,000자(이 한도를 초과하는 텍스트는 모두 삭제됨) |