포트폴리오진행 방식FAQ회사소개
아이디어 제안
Google Cloud

Google 번역 API 키 발급 가이드

Cloud Translation API 를 켜고 내 API 키를 만드는 방법입니다. 처음이어도 10분이면 끝납니다.

API 키가 꼭 필요한가요?

아닙니다. 없어도 앱은 동작합니다. 키가 없으면 기기 안에서 번역하고, 이때는 인터넷도 요금도 필요 없습니다.

키를 넣으면 번역이 더 정확해집니다. 구글 클라우드의 번역 품질이 기기 내장 모델보다 좋기 때문입니다. 더 나은 번역을 원할 때만 아래를 따라 하세요.

  • 매월 50만 자까지 무료 — 일반적인 사용량이라면 요금이 거의 발생하지 않습니다.
  • 키는 내 기기에만 저장되며 구글 외 어디로도 전송되지 않습니다.
  • 사용량 상한을 직접 정할 수 있습니다(6단계).
1

Google Cloud Console 로그인

먼저 Google Cloud Platform 계정이 필요합니다.

  1. Google Cloud Console 로 이동합니다.
  2. Google 계정으로 로그인합니다. 계정이 없다면 새로 만듭니다.
  3. 처음이라면 약관 동의와 결제 정보 입력이 필요할 수 있습니다. 신규 사용자에게는 90일간 쓸 수 있는 $300 무료 크레딧이 제공됩니다.
2

새 프로젝트 만들기

API 키를 만들기 전에 프로젝트를 하나 만듭니다.

  1. 화면 위쪽의 프로젝트 선택 메뉴를 클릭합니다.
  2. "새 프로젝트"를 선택합니다.
  3. 이름(예: Translate-Project)을 적고 "만들기"를 클릭합니다.
  4. 자동으로 바뀌지 않으면 선택 메뉴에서 방금 만든 프로젝트를 직접 고릅니다.
3

Cloud Translation API 켜기

프로젝트에서 번역 API 를 활성화합니다.

  1. 왼쪽 메뉴 "API 및 서비스" > "라이브러리"로 이동합니다.
  2. "Cloud Translation API"를 검색해 클릭합니다.
  3. "사용" 버튼을 누릅니다.
  4. 결제 계정 연결을 요구하면 연결합니다. 없으면 새로 만듭니다.

왜 v2 를 쓰나요?

Google 은 번역 API 를 두 가지로 제공합니다.

  • Basic (v2) — API 키로 인증합니다. 이 앱이 쓰는 방식입니다.
  • Advanced (v3) — 용어집 등 기능이 더 많지만 API 키를 지원하지 않고 서비스 계정 인증만 받습니다.

앱에 키를 붙여넣는 방식과 맞는 것은 v2 뿐이라, 이 앱과 가이드는 v2 를 씁니다.

4

API 키 만들기

API 를 켠 뒤 키를 만듭니다.

  1. API 및 서비스 > 사용자 인증 정보 로 이동합니다.
  2. 위쪽 "+ 사용자 인증 정보 만들기" > "API 키"를 선택합니다.
  3. 키가 만들어지면 복사해서 안전한 곳에 보관합니다. 창을 닫아도 목록에서 다시 볼 수 있습니다.
  4. 바로 닫지 말고 다음 단계에서 제한을 겁니다.
5

키에 제한 걸기 (꼭 하세요)

제한 없는 키는 유출되면 다른 구글 서비스까지 마음대로 쓰일 수 있습니다. 구글도 제한 설정을 강하게 권장합니다.

  1. 사용자 인증 정보 목록에서 방금 만든 키 이름을 클릭합니다.
  2. API 제한사항에서 "키 제한"을 고르고, 목록에서 Cloud Translation API 만 선택합니다.
  3. "저장"을 누릅니다.

참고

애플리케이션 제한(안드로이드 앱·IP 등)은 선택 사항입니다. 안드로이드 앱으로 제한하려면 패키지 이름과 서명 지문(SHA-1)이 필요한데 일반 사용자가 알기 어렵습니다. API 제한 + 사용 한도(6단계) 두 가지만 해도 피해 범위는 충분히 좁혀집니다.

6

사용 한도 정하기 (권장)

예상치 못한 요금을 막는 가장 확실한 방법입니다.

  1. "API 및 서비스" > "Cloud Translation API" > "할당량 및 시스템 한도"로 이동합니다.
  2. 문자 수 관련 할당량을 찾아 수정합니다.
  3. 월 500,000자를 넘지 않게 잡으면 무료 범위 안에서만 쓰게 됩니다.

키가 유출된 것 같다면

사용자 인증 정보 목록에서 해당 키를 삭제하고 새로 만드세요. 삭제하는 즉시 그 키는 동작하지 않습니다.

7

결제 설정 확인

Cloud Translation 은 사용량에 따라 요금이 매겨집니다.

  • 무료: 매월 500,000자 (매달 초기화)
  • 초과분: 100만 자당 약 $20
  • 최신 금액은 Google 가격 페이지에서 확인하세요.
  1. 왼쪽 메뉴 "결제"로 이동합니다.
  2. 프로젝트에 결제 계정이 연결됐는지 확인합니다.
  3. 예산 및 알림을 설정해 두면 금액이 넘을 때 메일로 알려 줍니다.
8

사용량 확인하기

가끔 들여다보면 요금이 예측 가능해집니다.

  1. "API 및 서비스" > "사용 설정된 API 및 서비스"로 이동합니다.
  2. "Cloud Translation API"를 클릭합니다.
  3. 측정항목 탭에서 최근 사용량을 봅니다.
  4. 할당량 탭에서 남은 한도를 확인하고 필요하면 조정합니다.

준비되셨나요?

Google Cloud Console 에서 위 단계를 따라가면 됩니다. 발급한 키는 앱 설정 화면에 붙여넣으면 바로 사용됩니다.

Google Cloud Console 열기