Cloud Translation API 개요
Cloud Translation API는 100개 이상 언어 쌍에 대해 텍스트를 번역할 수 있습니다. 소스 텍스트의 언어를 알 수 없어도 Cloud Translation API가 이를 감지할 수 있습니다. 지원되는 모든 언어 목록은 지원되는 언어를 참고하세요.
기업 조직은 기존 내부 워크플로에 번역된 텍스트를 포함시킬 수 있습니다. 예를 들어 여러 언어로 고객 사례를 수신하는 전 세계 지원팀이 운영되고 있을 수 있습니다. Cloud Translation API를 워크플로에 추가하여 고객 사례를 지원팀 구성원이 사용하는 언어로 번역할 수 있습니다. Cloud Translation API를 사용하면 텍스트를 직접 수동으로 번역하거나 다른 번역 서비스에 의존할 필요가 없기 때문에 지원팀의 업무 효율을 전반적으로 향상시킬 수 있습니다.
Cloud Translation API는 원활하게 확장되며 매일 무제한 문자 수 번역을 허용합니다. 하지만 각 요청의 콘텐츠 크기 및 요청 비율에 대한 제한이 있습니다. 또한 예산 관리를 위해 할당량 제한을 사용할 수 있습니다. 자세한 내용은 할당량 및 제한을 참조하세요.
Cloud Translation API는 Basic 버전과 Advanced 버전의 두 가지 버전으로 제공됩니다. 각 버전에서 지원되는 다양한 기능 목록은 버전 비교를 참고하세요.
Cloud Translation - Basic API
Basic 버전은 v2 클라이언트 라이브러리를 통해 액세스하며 최소한의 구성이 필요합니다. 인증을 위한 API 키와 서비스 계정을 허용하며 수정 없이 Google 사전 학습 인공신경망 기계 번역 (NMT) 모델을 사용합니다. 채팅, 소셜 미디어, 댓글과 같은 일상적인 사용자 제작 콘텐츠를 번역해야 하는 애플리케이션에 적합합니다.
기본적으로 Cloud Translation API는 더 많은 학습 데이터와 더 나은 기술을 사용할 수 있게 되었을 때 반 정기적으로 Google에서 업데이트하는 Basic 버전을 사용합니다.
하지만 새 프로젝트를 계획 중이라면 Advanced 버전을 선택하여 더 나은 보안, 더 많은 기능, Advanced 버전에서 앞으로 계속 제공될 새로운 서비스 개선사항을 활용하는 것이 좋습니다.
Cloud Translation - Advanced API
Advanced 버전은 v3 클라이언트 라이브러리를 통해 액세스하며 IAM 역할과 통합된 서비스 계정 인증이 필요합니다. 번역 LLM 모델, NMT 모델, NMT 맞춤설정을 비롯한 다양한 모델을 선택할 수 있습니다. 또한 용어집, 일괄 번역, 문서 번역과 같은 기능도 제공합니다.
Cloud Translation - Advanced API의 주요 기능은 다음과 같습니다.
더 많은 모델에 액세스 - 번역 LLM, Google의 인공신경망 기계 번역(NMT) 모델, 적응형 번역 모델, 사용자 또는 다른 사람이 만든 맞춤 NMT 모델과 같은 최첨단 번역 모델 중에서 적합한 모델을 선택하세요.
용어집 - 분야별 용어를 정확하고 일관되게 번역할 수 있는 커스텀 사전을 만듭니다.
일괄 요청 - 많은 양의 텍스트를 번역하도록 비동기 요청을 수행합니다.
문서 번역 - PDF 파일과 같은 문서를 번역하여 원본 형식과 레이아웃을 유지합니다.
IAM 역할 - Identity and Access Management를 사용하여 번역 요청을 보호합니다. 서비스 계정을 만들고 IAM 역할을 추가하여 여기에 권한을 부여합니다. Cloud Translation - Advanced API는 API 키를 지원하지 않습니다.
라벨 - 사용량을 더 효과적으로 추적하고 세부적인 청구 보고서를 받기 위해 사용자 정의된 라벨 (키-값 쌍)을 번역 요청에 추가할 수 있습니다.
리전 엔드포인트 - 프로젝트의 리소스가 저장되고 처리되는 위치를 제어할 수 있습니다.
용어집
용어집은 Cloud Translation - Advanced API가 도메인별 용어, 이름이 지정된 항목, 기타 사용자에게 특화된 용어를 정확하고 일관되게 번역할 수 있도록 지원하는 커스텀 사전입니다. 예를 들어 용어집을 사용하면 'Google 프로그래밍 경진대회(Summer of Code)', 'Gmail 비밀 모드' 또는 '게재위치 실적 보고서'와 같은 용어에 대한 구체적인 번역을 지정할 수 있습니다.
또한, 차용어나 제품 이름과 같은 특정 단어가 번역되는 것을 방지하는 데 용어집을 사용할 수도 있습니다. 용어집 사용 방법에 대한 자세한 내용은 용어집 만들기 및 사용을 참고하세요.
일괄 요청
일괄 번역 요청은 Cloud Storage 버킷의 입력을 번역하는 비동기식 요청입니다. Cloud Translation - Advanced API는 일괄 번역을 장기 실행 작업으로 수행하고 지정된 Cloud Storage 버킷에 출력을 기록합니다. 일괄 번역에 대한 인라인 요청은 지원되지 않습니다.
일괄 요청 실행에 대한 자세한 내용은 일괄 요청(Advanced)을 참고하세요.
Document Translation
Document Translation을 사용하면 PDF, DOCX 파일과 같은 기존 문서를 도착어로 직접 번역할 수 있습니다. Document Translation은 원본 문서의 레이아웃과 형식이 원본 문서와 동일하도록 원본 형식을 유지합니다. 예를 들어 Document Translation은 번역된 콘텐츠가 원본 문서에서와 같이 분할되도록 단락 구분과 제목을 유지합니다.
용어집 및 AutoML 모델과 같은 Cloud Translation - Advanced API 기능도 Document Translation에서 사용할 수 있습니다. 예를 들어, 텍스트 번역에 사용하는 기존 AutoML 모델이 있다면 동일한 모델을 Document Translation에도 사용할 수 있습니다. 지원되는 파일 형식 및 문서 번역 방법에 대한 자세한 내용은 문서 번역을 참고하세요.
모델 선택 및 AutoML 모델
Cloud Translation - Advanced API 모델 선택을 사용하면 번역하려는 콘텐츠 및 컨텍스트에 따라 번역 LLM (적응형 번역을 위해 추가로 맞춤설정할 수도 있음), Google의 NMT 모델 또는 맞춤 AutoML Translation 모델 중에서 애플리케이션에 적합한 모델을 동적으로 선택할 수 있습니다.
분야별 용어를 더 정확하게 번역하기 위해 AutoML Translation을 사용하여 커스텀 모델을 만드세요. 그런 후 Cloud Translation - Advanced API에서 결과 모델을 사용하여 텍스트를 번역할 수 있습니다.
커스텀 모델을 사용한 텍스트 번역에 대한 자세한 내용은 텍스트 번역(Advanced)을 참고하세요.
IAM 역할
Cloud Translation - Advanced API는 IAM과의 통합으로 번역 요청의 보안을 강화하고, 정밀한 액세스 제어를 사용 설정하고, AutoML Translation과의 통합을 지원합니다.
이러한 계정에 Cloud Translation - Advanced API에 대한 액세스 권한을 부여하려면 다음 역할 중 하나에 사용자 및 서비스 계정을 추가해야 합니다. 서비스 계정 만들기에 대한 자세한 내용은 IAM 문서의 서비스 계정 만들기 및 관리를 참고하세요.
| 역할 | 역할 ID | 설명 |
|---|---|---|
| Cloud Translation API 뷰어 | roles/cloudtranslate.viewer |
get 및 list 작업에 액세스할 수 있습니다. |
| Cloud Translation API 사용자 | roles/cloudtranslate.user |
|
| Cloud Translation API 편집자 | roles/cloudtranslate.editor |
|
| Cloud Translation API 관리자 | roles/cloudtranslate.admin |
|
각 역할에 포함된 권한 목록을 보려면 역할 이해를 참고하세요.
사전 구성된 역할은 일반적인 여러 사용 사례를 다룹니다. 그러나 커스텀 권한 집합을 포함하는 역할이 필요할 수도 있습니다. 예를 들어, 프로젝트에 용어집을 만들 수는 있되 프로젝트의 기존 용어집을 삭제하거나 업데이트할 수는 없는 역할을 만들고 싶을 수 있습니다. 이러한 경우 그러한 요구 사항에 맞는 IAM 커스텀 역할을 만들 수 있습니다.
IAM 역할 관리에 대한 자세한 내용은 리소스에 대한 액세스 권한 부여, 변경, 취소와 서비스 계정에 역할 부여를 참조하세요.
라벨
Cloud Translation - Advanced API를 사용하면 TranslateText, BatchTranslateText, DetectLanguage 요청에 사용자 정의 라벨 (키-값 쌍)을 추가할 수 있습니다.
요청 사용량에 대한 정보는 결제 시스템을 전달되고 여기에서 라벨을 필터링하여 청구 상세 내역을 확인할 수 있습니다.
사용자 정의 라벨에 대한 자세한 내용은 라벨을 사용하여 사용량 보고하기(Advanced)를 참고하세요.
리전 엔드포인트
기본적으로 Cloud Translation - Advanced API는 글로벌 위치에 리소스를 저장하고 처리합니다. 따라서, 리소스가 특정 위치에 남아 있다는 보장이 없습니다. 기본값 글로벌 엔드포인트를 사용하는 대신 리전 엔드포인트를 사용하여 유럽연합과 같은 특정 위치 내에 리소스를 유지할 수 있습니다. 자세한 내용은 리전 엔드포인트 지정을 참고하세요.
버전 비교
다음 표는 각 버전에서 제공되는 기능을 보여줍니다.
| 기능 | 기본 | 고급 |
|---|---|---|
| NMT 모델을 사용한 번역 | ||
| 번역 LLM을 사용한 번역 | ||
| 적응형 번역 모델을 사용한 번역 | ||
| 커스텀 모델을 사용한 번역 | ||
| 단일 요청으로 여러 문자열 번역 | ||
| Cloud Storage를 사용한 일괄 번역 | ||
| 문서 번역 | ||
| 용어집 지원(제어 용어) | ||
| 커스텀 모델 학습 | ||
| 언어 감지 | ||
| 통합된 REST API | ||
| 통합된 gRPC API | ||
| 서비스 계정 | ||
| API 키 | ||
| 감사 로깅 | ||
| HTML 지원 | ||
| 100개 이상의 언어 지원 | ||
| 로마자 지원 | ||
| 음역 지원 | ||
| 적응형 번역 | ||
| 멀티 리전 엔드포인트 지원 | ||
| VPC 서비스 제어 지원 |
Cloud Translation - Advanced API에 대한 자세한 내용은 Cloud Translation - Advanced API 기능을 참고하세요.
가격 책정
Cloud Translation API는 전송한 문자 수를 기준으로 월별 요금을 부과합니다. 자세한 내용은 가격 책정을 참조하세요.
리소스 및 추가 자료
- API 사용을 시작하려면 설정 후 빠른 시작 가이드를 사용해 보세요.
- 지원되는 모델 비교
- NMT 모델 맞춤설정
- 번역 LLM 맞춤설정
- 지원되는 언어
- 지원되는 형식
- 적응형 번역 수행
- Translation Advanced로 마이그레이션
- Cloud Translation API에 대한 일반적인 질문과 답변은 일반 FAQ 페이지를 참고하세요.