Cloud Vision API 설정

향상된 텍스트 인식을 위한 선택적 가이드

매월 처음 1,000회 스캔은 항상 무료입니다. 일반적인 사용에는 충분합니다.

API 키를 다른 사람과 공유하지 마세요. 키 사용량은 할당량에 포함되며 요금이 청구될 수 있습니다.

왜 Cloud Vision을 사용하나요?

기기 내장 텍스트 인식은 대부분의 아이템에서 잘 작동합니다. 그러나 특정 아이템에 문제가 있거나 더 나은 정확도를 원한다면, 클라우드 기반 텍스트 인식을 위해 Google Cloud Vision을 선택적으로 활성화할 수 있습니다.

이것은 완전히 선택 사항입니다 — 앱은 이것 없이도 완벽하게 작동합니다.

설정 방법

Google Cloud Console 로그인

console.cloud.google.com에 접속하여 Google 계정으로 로그인하세요.

Google 계정이 없다면 무료로 만들 수 있습니다.

새 프로젝트 만들기

상단 탐색 바에서 프로젝트 드롭다운을 클릭하고 "New Project" (새 프로젝트)를 선택하세요.

아무 이름이나 입력하세요 (예: exile-companion), 그리고 "Create" (만들기)를 클릭하세요.

Cloud Vision API 활성화

왼쪽 메뉴에서 "APIs & Services" → "Library"로 이동하세요.

Cloud Vision API를 검색하고 클릭하세요.

"Enable" (활성화) 버튼을 클릭하세요.

결제 설정

Google은 무료 등급에서도 Cloud Vision을 사용하려면 활성 결제 계정이 필요합니다. 월 1,000회 스캔 이내라면 요금이 청구되지 않습니다.

  1. Google Cloud Console의 Billing으로 이동
  2. 결제 계정이 없으면 "Create account" 클릭
  3. 결제 계정 이름을 입력하고 국가를 선택한 후 "Continue" 클릭
  4. 결제 수단(신용카드)을 추가하고 "Submit and enable billing" 클릭
  5. "My projects" 탭으로 이동하여 프로젝트 찾기
  6. Actions 메뉴(⋮) → "Change billing" 클릭
  7. 결제 계정을 선택하고 "Set account" 클릭

API 키 만들기

"APIs & Services" → "Credentials"로 이동하세요.

"+ Create Credentials" → "API Key"를 클릭하세요.

키가 생성되어 표시됩니다. 복사하세요.

앱에 키 붙여넣기

Exile Companion을 열고 설정 → 인식으로 이동하세요.

Cloud Vision 토글을 활성화하고 "구성"을 탭하세요.

API 키를 붙여넣고 "저장"을 탭하세요.

완료! 이제 텍스트 인식에 Cloud Vision이 활성화되었습니다.

자주 묻는 질문

비용은 얼마인가요?

매월 처음 1,000회 스캔은 무료입니다. 대부분의 플레이어에게는 충분합니다. 그 이후에는 1,000회 스캔당 $1.50입니다.

안전한가요?

네. API 키는 기기에만 저장됩니다. 저희는 귀하의 키나 Google 계정에 접근할 수 없습니다.

여러 기기에서 하나의 키를 사용할 수 있나요?

네, 모든 기기에서 같은 키를 사용할 수 있습니다. 1,000회 요청 한도는 모든 기기에서 공유됩니다.

키를 어떻게 제거하나요?

앱에서 설정 → 인식 → Cloud Vision 섹션으로 이동하여 "제거"를 탭하세요.

사용량을 어떻게 확인하나요?

Google Cloud Console → "APIs & Services" → "Dashboard"에서 사용 통계를 확인하세요.

키를 잊었거나 새 키가 필요한가요?

Google Cloud Console → "APIs & Services" → "Credentials"에서 기존 키를 보거나 새 키를 만들 수 있습니다.

문제 해결

"API access denied" 오류

이 오류가 표시되면 다음을 확인하세요:

  1. Cloud Vision API가 활성화되어 있나요? (3단계)
  2. 결제가 설정되고 프로젝트에 연결되어 있나요? (4단계)
  3. API 키에 Cloud Vision을 차단하는 제한이 있나요?