Cloud Translation - Advanced에서는 커스텀 모델을 사용하여 텍스트 번역을 지원하고 Cloud Translation API가 고객의 분야별 용어를 정확하게 번역하도록 용어집 만들기를 지원합니다.
Google Cloud CLI 설치, 서비스 계정으로 프로젝트 설정, 액세스 토큰 획득 방법은 설정 페이지를 참조하세요. 용어집 또는 일괄 요청 기능을 사용하려면 Cloud Storage 버킷을 만들고 서비스 계정에 이 버킷에 대한 액세스 권한을 부여해야 합니다.
PDF와 같이 형식이 지정된 문서를 번역하려면 문서 번역을 참조하세요.
시작하기 전에
Cloud Translation API를 사용을 시작하려면 Cloud Translation API가 사용 설정된 프로젝트가 있고 적절한 사용자 인증 정보가 있어야 합니다. 공통 프로그래밍 언어용 클라이언트 라이브러리를 설치하여 API를 호출할 수도 있습니다. 자세한 내용은 설정 페이지를 참조하세요.
모델 비교
Cloud Translation - Advanced에서 번역을 요청할 때 사용할 번역 모델을 지정할 수 있습니다. 모델이 지정되지 않으면 nmt
모델이 사용됩니다.
모델 | 모델 ID | 적합한 분야 | 예 |
---|---|---|---|
인공신경망 기계 번역(NMT) 모델 | general/nmt |
분야와 관련이 없는 일반 웹사이트 콘텐츠와 같은 일반 텍스트 사용 사례(예: 뉴스 기사) |
뉴스 기사, 소셜 미디어, 채팅 애플리케이션, 리뷰 |
번역 대규모 언어 모델(LLM)(미리보기) | general/translation-llm |
이를 위한 대체 모델은 Cloud Translation - Advanced에서 두 가지 모드로 제공됩니다. 대화 메시지와 같이 맞춤설정이 필요하지 않은 일반적인 텍스트 사용 사례를 위한 텍스트 번역입니다. 예시가 포함된 데이터 세트를 사용하여 실시간으로 맞춤설정을 지원하는 적응형 번역 |
뉴스 기사, 소셜 미디어, 채팅 애플리케이션, 리뷰 |
AutoML Translation 모델 | 모델 ID는 모델 학습이 완료된 후에 생성됩니다. | 분야별 텍스트. 사용자는 주어진 언어 조합에서 사용 사례별 학습 데이터를 제공하여 Google의 분야별 NMT 모델을 맞춤설정합니다. | 금융 뉴스, 기술 문서, 특정 필드에 고유한 용어와 특수 용어를 사용하는 모든 텍스트 |
고려사항
각 모델은 자체 설정된 언어를 지원합니다. 출발어와 도착어가 지원되는지 확인하세요. 자세한 내용은 지원되는 언어를 참조하세요.
텍스트 번역
번역의 경우 입력은 일반 텍스트 또는 HTML일 수 있습니다. Cloud Translation API는 입력된 HTML 태그를 번역하지 않으며 태그 사이에 표시되는 텍스트만 번역합니다. 출력에는 (번역되지 않은) HTML 태그가 유지되며, 출발어와 도착어 간의 차이로 인해 태그 사이의 텍스트가 가능한 한 번역되어 포함됩니다.
입력 문자열 번역
REST
텍스트를 번역하려면 POST
요청을 실행하고 출발어(source_language_code
), 도착어(target_language_code
), 번역할 텍스트(contents
)를 식별하는 JSON을 요청 본문에 삽입합니다. 번역할 여러 텍스트 문자열을 JSON에 포함하여 제공할 수 있습니다(예시 참조). ISO-639 코드를 사용하여 출발어와 도착어를 지정하세요.
다음은 curl
또는 PowerShell을 사용한 POST
요청의 예시입니다. 이 예시에서는 Google Cloud Google Cloud CLI를 사용하여 프로젝트에 설정된 서비스 계정의 액세스 토큰을 사용합니다.
Google Cloud CLI 설치, 서비스 계정으로 프로젝트 설정, 액세스 토큰 획득 방법은 설정 페이지를 참조하세요.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_NUMBER_OR_ID: Google Cloud 프로젝트의 숫자 또는 영숫자 ID
HTTP 메서드 및 URL:
POST https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID:translateText
JSON 요청 본문:
{ "sourceLanguageCode": "en", "targetLanguageCode": "ru", "contents": ["Dr. Watson, come here!", "Bring me some coffee!"] }
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
다음과 비슷한 JSON 응답이 표시됩니다.
{ "translations": [ { "translatedText": "Доктор Ватсон, иди сюда!", }, { "translatedText": "Принеси мне кофе!", } ] }
translations
배열에는 요청한 targetLanguageCode
언어(ru
: 러시아어)로 번역된 translatedText
필드 2개가 포함되어 있습니다. 번역은 요청에 있는 원본 텍스트 배열과 동일한 순서로 표시됩니다.
Go
이 샘플을 사용해 보기 전에 Cloud Translation 빠른 시작: 클라이언트 라이브러리 사용의 Go 설정 안내를 따르세요. 자세한 내용은 Cloud Translation Go API 참고 문서를 확인하세요.
Cloud Translation에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Java
이 샘플을 사용해 보기 전에 Cloud Translation 빠른 시작: 클라이언트 라이브러리 사용의 Java 설정 안내를 따르세요. 자세한 내용은 Cloud Translation Java API 참고 문서를 확인하세요.
Cloud Translation에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Node.js
이 샘플을 사용해 보기 전에 Cloud Translation 빠른 시작: 클라이언트 라이브러리 사용의 Node.js 설정 안내를 따르세요. 자세한 내용은 Cloud Translation Node.js API 참고 문서를 확인하세요.
Cloud Translation에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Python
이 샘플을 사용해 보기 전에 Cloud Translation 빠른 시작: 클라이언트 라이브러리 사용의 Python 설정 안내를 따르세요. 자세한 내용은 Cloud Translation Python API 참고 문서를 확인하세요.
Cloud Translation에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
추가 언어
C#: 클라이언트 라이브러리 페이지의 C# 설정 안내를 따른 후 .NET용 Cloud Translation 참조 문서를 참조하세요.
PHP: 클라이언트 라이브러리 페이지의 PHP 설정 안내를 따른 후 PHP용 Cloud Translation 참고 문서를 참조하세요.
Ruby: 클라이언트 라이브러리 페이지의 Ruby 설정 안내를 따른 다음 Ruby용 Cloud Translation 참고 문서를 참조하세요.
특정 모델을 사용하여 텍스트 번역
REST
model
쿼리 매개변수를 사용하면 번역에 사용할 모델을 지정할 수 있습니다.
다음 예시에서는 모델 ID가 1395675701985363739
인 커스텀 모델을 사용하여 텍스트를 번역합니다. Google Cloud 콘솔의 모델 목록 또는 모델을 학습시킬 때 API 응답에서 커스텀 모델의 모델 ID를 가져올 수 있습니다. 변환 LLM을 사용하려면 general/translation-llm
을 모델 ID로 지정합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_ID: Google Cloud 프로젝트 ID
- LOCATION: 커스텀 모델이 있는 리전입니다(예:
us-central1
).
HTTP 메서드 및 URL:
POST https://translation.googleapis.com/v3/projects/PROJECT_ID/locations/LOCATION:translateText
JSON 요청 본문:
{ "model": "projects/PROJECT_ID/locations/LOCATION/models/1395675701985363739", "sourceLanguageCode": "en", "targetLanguageCode": "ru", "contents": ["Dr. Watson, please discard your trash. You've shared unsolicited email with me. Let's talk about spam and importance ranking in a confidential mode."] }
요청을 보내려면 다음 옵션 중 하나를 선택합니다.
curl
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "x-goog-user-project: PROJECT_ID" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://translation.googleapis.com/v3/projects/PROJECT_ID/locations/LOCATION:translateText"
PowerShell
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://translation.googleapis.com/v3/projects/PROJECT_ID/locations/LOCATION:translateText" | Select-Object -Expand Content
다음과 비슷한 JSON 응답이 표시됩니다.
{ "translation": { "translatedText": "Доктор Ватсон, пожалуйста, откажитесь от своего мусора. Вы поделились нежелательной электронной почтой со мной. Давайте поговорим о спаме и важности рейтинга в конфиденциальном режиме.", "model": "projects/PROJECT_NUMBER/locations/LOCATION/models/1395675701985363739" } }
Go
이 샘플을 사용해 보기 전에 Cloud Translation 빠른 시작: 클라이언트 라이브러리 사용의 Go 설정 안내를 따르세요. 자세한 내용은 Cloud Translation Go API 참고 문서를 확인하세요.
Cloud Translation에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Java
이 샘플을 사용해 보기 전에 Cloud Translation 빠른 시작: 클라이언트 라이브러리 사용의 Java 설정 안내를 따르세요. 자세한 내용은 Cloud Translation Java API 참고 문서를 확인하세요.
Cloud Translation에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Node.js
이 샘플을 사용해 보기 전에 Cloud Translation 빠른 시작: 클라이언트 라이브러리 사용의 Node.js 설정 안내를 따르세요. 자세한 내용은 Cloud Translation Node.js API 참고 문서를 확인하세요.
Cloud Translation에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Python
이 샘플을 사용해 보기 전에 Cloud Translation 빠른 시작: 클라이언트 라이브러리 사용의 Python 설정 안내를 따르세요. 자세한 내용은 Cloud Translation Python API 참고 문서를 확인하세요.
Cloud Translation에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
추가 언어
C#: 클라이언트 라이브러리 페이지의 C# 설정 안내를 따른 후 .NET용 Cloud Translation 참조 문서를 참조하세요.
PHP: 클라이언트 라이브러리 페이지의 PHP 설정 안내를 따른 후 PHP용 Cloud Translation 참고 문서를 참조하세요.
Ruby: 클라이언트 라이브러리 페이지의 Ruby 설정 안내를 따른 다음 Ruby용 Cloud Translation 참고 문서를 참조하세요.
음역
음역은 translateText
메서드의 구성 설정입니다. 음역을 사용 설정하면 로마자 텍스트(라틴 문자)를 도착어로 직접 번역합니다. 예를 들어 로마자 일본어 텍스트를 영어, 스페인어 또는 중국어로 직접 번역할 수 있습니다. 결과 번역은 도착어의 쓰기 시스템에 나타납니다.
음역 요청에는 로마자 텍스트만 포함하세요. 로마자 텍스트와 비로마자 텍스트를 혼합하는 경우 Cloud Translation에서 일관되고 적절한 번역을 보장할 수 없습니다.
고려사항
음역은 다음과 같은 점에서 표준 텍스트 번역과 다릅니다.
- 음역은 제한된 수의 언어를 지원합니다. 자세한 내용은 지원되는 언어 페이지에서 음역 열을 참조하세요.
- MIME 유형은
text/plain
이어야 합니다. HTML은 지원되지 않습니다. - 음역은 기본 표준 모델에서만 지원됩니다. 커스텀 모델은 지원되지 않습니다.
- 음역은 기본 콘텐츠 할당량이 더 적습니다. 자세한 내용은 할당량 및 한도를 참조하세요.
REST
translateText
메서드에서 transliteration_config
필드를 설정합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_NUMBER_OR_ID: Google Cloud 프로젝트의 숫자 또는 영숫자 ID
- LOCATION: 이 작업을 실행할 리전입니다. 예를 들면
us-central1
입니다. - SOURCE_LANGUAGE: (선택사항) 입력 텍스트의 언어 코드입니다. 알려진 경우 언어 지원에 나열된 언어 코드 중 하나로 설정합니다.
- TARGET_LANGUAGE: 입력 텍스트를 번역할 도착어입니다. 언어 지원에 나열된 언어 코드 중 하나로 설정합니다.
- SOURCE_TEXT: 번역할 출발어의 로마자 텍스트입니다.
HTTP 메서드 및 URL:
POST https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION:translateText
JSON 요청 본문:
{ "source_language_code": "SOURCE_LANGUAGE", "target_language_code": "TARGET_LANGUAGE", "contents": "SOURCE_TEXT", "mime_type": "text/plain", "transliteration_config": { "enable_transliteration": true} }
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
다음과 비슷한 JSON 응답이 표시됩니다.
{ "translations": [ { "translatedText": "TRANSLATED_TEXT", } ] }
추가 리소스
- 일반적인 문제 또는 오류를 해결하는 데 도움이 필요하면 문제 해결 페이지를 참조하세요.