Google 번역 API 사용 튜토리얼

Tags:
Categories:

자동 번역 작업을 위해 API를 사용해야 한다면 Google 번역 API는 좋은 선택입니다. DeepL보다 번역 품질이 약간 떨어질 수 있지만 비용 대비 효율이 뛰어나며 특히 매월 50만 문자의 무료 할당량이 제공됩니다.

제품 소개

Google 번역은 모두가 사용해봤겠지만 여기서 소개하는 것은 API 서비스로, 전체 이름은 Google Cloud Translation입니다. API를 통해 대량 번역, 사용자 정의 번역 모델, 문서 번역 등의 기능을 구현할 수 있습니다.

제품 소개

가격

매월 50만 문자 무료 할당량, 초과 시 문자당 과금.

가격 차트

기본판과 고급판 차이점

기능 기본판 고급판
무료 할당량 50만 문자/월 50만 문자/월
백만 문자당 20 달러 80 달러
문서 번역 0.08/페이지 0.25/페이지
사용자 정의 번역 ✘ ✔

사용 시작하기

프로젝트 생성 또는 선택

  • API 사용 설정, 결제 기능이 활성화되지 않은 경우 여기서 결제 계정 추가를 요청하는 메시지가 표시됩니다. 외화 신용카드 필요

활성화

API 활성화

    $cred = gcloud auth print-access-token
    $project_id = "example"
    $headers = @{ "Authorization" = "Bearer $cred" }
    Invoke-WebRequest `
        -Method GET `
        -Headers $headers `
        -Uri "https://cloudresourcemanager.googleapis.com/v3/projects/${project_id}" | Select-Object -Expand Content
  • 테스트
    $cred = gcloud auth print-access-token
    $project_id = "example"
    $body = @{
        "sourceLanguageCode" = "en"
        "targetLanguageCode" = "zh"
        "contents" = @("Hello, world!")
        "mimeType" = "text/plain"
    }
    $body = $body | ConvertTo-Json
    $headers = @{
        "Authorization" = "Bearer $cred"
        "Content-Type" = "application/json; charset=utf-8"
        "x-goog-user-project" = $project_id
    }
    Invoke-WebRequest `
        -Method POST `
        -Headers $headers `
        -Uri "https://translation.googleapis.com/v3/projects/${project_id}:translateText" `
        -Body $body | Select-Object -Expand Content

실행 성공

Linux에서는 curl 명령 사용

    export CRED=$(gcloud auth print-access-token)
    export PROJECT_ID="example"
    export SOURCE_LANGUAGE_CODE="en"
    export TARGET_LANGUAGE_CODE="zh"
    export CONTENTS="Hello, world!"
    export MIME_TYPE="text/plain"
    curl -X POST -H "Authorization: Bearer $CRED" -H "Content-Type: application/json; charset=utf-8" -H "x-goog-user-project: $PROJECT_ID" -d "{
        \"sourceLanguageCode\": \"$SOURCE_LANGUAGE_CODE\",
        \"targetLanguageCode\": \"$TARGET_LANGUAGE_CODE\",
        \"contents\": [\"$CONTENTS\"],
        \"mimeType\": \"$MIME_TYPE\"
    }" "https://translation.googleapis.com/v3/projects/$PROJECT_ID:translateText"

이제 Google 번역 API를 사용하여 대량 번역을 할 수 있습니다.

활용 예시

  • 웹사이트 또는 애플리케이션 번역
  • 사용자 정의 번역 모델 학습
  • 영상에 다른 언어 자막 추가
  • 영상에 다른 언어로 녹음
  • 서식 있는 문서 번역
  • 고객 상호작용 내용 실시간 번역

확장 읽기

마무리

Google 번역의 공식 문서는 매우 방대하며 동일한 기능을 구현하는 방법이 여러 가지이고 인증 및 호출 단계에서도 다양한 방법이 있습니다. 본문은 일반 사용자에게 가장 권장되고 간단한 사용 방법만을 선택하여 참고용으로 제공합니다.

  • 인증 방법 중 로컬 인증(gcloud CLI) 선택
  • 사용 방법 중 REST API(Curl/Invoke-WebRequest) 선택
  • 기본판과 고급판 중 고급판 선택

이 글은 원문이 blog.jqknono.dev에 발표된 원작이며, 허가 없이 전재 금지