API 키 Gemini

Gemini API Key 발급 방법

Gemini를 사용해 AI 원제 검색을 하려면 Google AI Studio에서 Gemini API Key를 만들어야 합니다.

이 문서는 컴퓨터 사용이 익숙하지 않은 사용자를 기준으로 설명합니다. Google 화면은 자주 바뀌므로 버튼 이름이 조금 다를 수 있습니다.

준비할 것

• Google 계정
• 웹 브라우저
• BookManager 앱

전체 순서

1. Google AI Studio에 접속합니다.
2. Google 계정으로 로그인합니다.
3. API Key 화면을 엽니다.
4. 새 키를 만듭니다.
5. 키를 복사해 BookManager에 붙여 넣습니다.

1. Google AI Studio 열기

1. 웹 브라우저를 엽니다.

2. 아래 주소로 이동합니다.

   https://aistudio.google.com/apikey

3. Google 계정으로 로그인합니다.

4. 처음 접속하면 약관 동의 화면이 나올 수 있습니다. 내용을 확인하고 진행합니다.

2. API 키 만들기

1. API keys 화면에서 Create API key 또는 API 키 만들기 버튼을 찾습니다.
2. 버튼을 누릅니다.
3. 프로젝트 선택 화면이 나오면 기존 프로젝트를 선택하거나 새 프로젝트를 만듭니다.
4. 키가 생성되면 화면에 표시된 API Key를 복사합니다.

Gemini API Key는 보통 AIza로 시작하는 긴 문자열입니다. 일부만 복사하면 동작하지 않으므로 전체를 복사해야 합니다.

3. BookManager에 입력하기

1. BookManager를 엽니다.
2. 환경 설정을 엽니다.
3. API 및 검색 설정 탭으로 이동합니다.
4. AI 원제 검색을 켭니다.
5. AI 모델 선택을 Gemini로 둡니다.
6. API Key 입력칸에 복사한 Gemini API Key를 붙여 넣습니다.
7. 저장을 누릅니다.
8. 메타데이터 관리 탭에서 AniList 또는 Comic Vine 검색을 테스트합니다.

키가 만들어지지 않을 때

Google AI Studio에서 키 생성 버튼이 비활성화되거나 권한 오류가 나오면 다음을 확인하세요.

• 개인 Google 계정으로 로그인했는지 확인합니다.
• 회사나 학교 계정이라면 관리자가 AI Studio 사용을 막았을 수 있습니다.
• 다른 Google 계정으로 다시 시도합니다.
• 프로젝트 선택 화면에서 새 프로젝트를 만들어 봅니다.

Google 공식 문서에 따르면 Gemini API 키는 Google Cloud 프로젝트와 연결됩니다. 새 사용자는 Google AI Studio에서 기본 프로젝트와 키가 자동으로 만들어질 수 있습니다.

오래된 키를 쓰고 있다면

Google은 Gemini API 키 정책을 변경하고 있습니다. 공식 문서 기준으로 새 Google AI Studio 키는 인증 키 형태로 생성되며, 오래된 표준 키는 제한 설정이 없으면 동작하지 않을 수 있습니다.

예전에 만든 키로 검색이 실패한다면 Google AI Studio에서 새 API Key를 다시 만들어 BookManager에 입력하세요.

결제나 사용량 안내가 나올 때

Gemini API는 무료 사용량, 요금제, 지역 제한이 바뀔 수 있습니다. 결제 정보를 요구하는 화면이 나오면 내용을 충분히 확인한 뒤 진행하세요.

원하지 않으면 AI 원제 검색을 끄고, AniList 또는 Comic Vine 검색어를 직접 입력해도 됩니다.

잘 안 될 때

• API Key 앞뒤에 빈칸이 들어가지 않았는지 확인합니다.
• AI 모델 선택이 Gemini인지 확인합니다.
• BookManager 설정 저장 후 앱을 다시 실행해 봅니다.
• 키를 방금 만들었다면 몇 분 뒤 다시 시도합니다.
• 회사나 학교 Google 계정이면 개인 Google 계정으로 시도해 봅니다.

참고

• Gemini API Key 공식 안내: https://ai.google.dev/gemini-api/docs/api-key
• Google AI Studio API Key 페이지: https://aistudio.google.com/apikey