Google 번역 API 키 발급 가이드
Cloud Translation API 를 켜고 내 API 키를 만드는 방법입니다. 처음이어도 10분이면 끝납니다.
API 키가 꼭 필요한가요?
아닙니다. 없어도 앱은 동작합니다. 키가 없으면 기기 안에서 번역하고, 이때는 인터넷도 요금도 필요 없습니다.
키를 넣으면 번역이 더 정확해집니다. 구글 클라우드의 번역 품질이 기기 내장 모델보다 좋기 때문입니다. 더 나은 번역을 원할 때만 아래를 따라 하세요.
- 매월 50만 자까지 무료 — 일반적인 사용량이라면 요금이 거의 발생하지 않습니다.
- 키는 내 기기에만 저장되며 구글 외 어디로도 전송되지 않습니다.
- 사용량 상한을 직접 정할 수 있습니다(6단계).
Google Cloud Console 로그인
먼저 Google Cloud Platform 계정이 필요합니다.
- Google Cloud Console 로 이동합니다.
- Google 계정으로 로그인합니다. 계정이 없다면 새로 만듭니다.
- 처음이라면 약관 동의와 결제 정보 입력이 필요할 수 있습니다. 신규 사용자에게는 90일간 쓸 수 있는 $300 무료 크레딧이 제공됩니다.
새 프로젝트 만들기
API 키를 만들기 전에 프로젝트를 하나 만듭니다.
- 화면 위쪽의 프로젝트 선택 메뉴를 클릭합니다.
- "새 프로젝트"를 선택합니다.
- 이름(예: Translate-Project)을 적고 "만들기"를 클릭합니다.
- 자동으로 바뀌지 않으면 선택 메뉴에서 방금 만든 프로젝트를 직접 고릅니다.
Cloud Translation API 켜기
프로젝트에서 번역 API 를 활성화합니다.
- 왼쪽 메뉴 "API 및 서비스" > "라이브러리"로 이동합니다.
- "Cloud Translation API"를 검색해 클릭합니다.
- "사용" 버튼을 누릅니다.
- 결제 계정 연결을 요구하면 연결합니다. 없으면 새로 만듭니다.
왜 v2 를 쓰나요?
Google 은 번역 API 를 두 가지로 제공합니다.
- Basic (v2) — API 키로 인증합니다. 이 앱이 쓰는 방식입니다.
- Advanced (v3) — 용어집 등 기능이 더 많지만 API 키를 지원하지 않고 서비스 계정 인증만 받습니다.
앱에 키를 붙여넣는 방식과 맞는 것은 v2 뿐이라, 이 앱과 가이드는 v2 를 씁니다.
API 키 만들기
API 를 켠 뒤 키를 만듭니다.
- API 및 서비스 > 사용자 인증 정보 로 이동합니다.
- 위쪽 "+ 사용자 인증 정보 만들기" > "API 키"를 선택합니다.
- 키가 만들어지면 복사해서 안전한 곳에 보관합니다. 창을 닫아도 목록에서 다시 볼 수 있습니다.
- 바로 닫지 말고 다음 단계에서 제한을 겁니다.
키에 제한 걸기 (꼭 하세요)
제한 없는 키는 유출되면 다른 구글 서비스까지 마음대로 쓰일 수 있습니다. 구글도 제한 설정을 강하게 권장합니다.
- 사용자 인증 정보 목록에서 방금 만든 키 이름을 클릭합니다.
- API 제한사항에서 "키 제한"을 고르고, 목록에서 Cloud Translation API 만 선택합니다.
- "저장"을 누릅니다.
참고
애플리케이션 제한(안드로이드 앱·IP 등)은 선택 사항입니다. 안드로이드 앱으로 제한하려면 패키지 이름과 서명 지문(SHA-1)이 필요한데 일반 사용자가 알기 어렵습니다. API 제한 + 사용 한도(6단계) 두 가지만 해도 피해 범위는 충분히 좁혀집니다.
사용 한도 정하기 (권장)
예상치 못한 요금을 막는 가장 확실한 방법입니다.
- "API 및 서비스" > "Cloud Translation API" > "할당량 및 시스템 한도"로 이동합니다.
- 문자 수 관련 할당량을 찾아 수정합니다.
- 월 500,000자를 넘지 않게 잡으면 무료 범위 안에서만 쓰게 됩니다.
키가 유출된 것 같다면
사용자 인증 정보 목록에서 해당 키를 삭제하고 새로 만드세요. 삭제하는 즉시 그 키는 동작하지 않습니다.
결제 설정 확인
Cloud Translation 은 사용량에 따라 요금이 매겨집니다.
- 무료: 매월 500,000자 (매달 초기화)
- 초과분: 100만 자당 약 $20
- 최신 금액은 Google 가격 페이지에서 확인하세요.
- 왼쪽 메뉴 "결제"로 이동합니다.
- 프로젝트에 결제 계정이 연결됐는지 확인합니다.
- 예산 및 알림을 설정해 두면 금액이 넘을 때 메일로 알려 줍니다.
사용량 확인하기
가끔 들여다보면 요금이 예측 가능해집니다.
- "API 및 서비스" > "사용 설정된 API 및 서비스"로 이동합니다.
- "Cloud Translation API"를 클릭합니다.
- 측정항목 탭에서 최근 사용량을 봅니다.
- 할당량 탭에서 남은 한도를 확인하고 필요하면 조정합니다.
준비되셨나요?
Google Cloud Console 에서 위 단계를 따라가면 됩니다. 발급한 키는 앱 설정 화면에 붙여넣으면 바로 사용됩니다.
Google Cloud Console 열기