# Gemini Live API 키 발급 가이드

## 필요한 API 키 종류

**Gemini Live API**를 사용하기 위해서는 **Google AI Studio (makersuite.google.com)**에서 발급받은 **Gemini API 키**가 필요합니다.

⚠️ **주의사항:**
- Vertex AI API 키가 아닙니다
- 서비스 계정 OAuth 토큰이 아닙니다
- 일반 Gemini API 키입니다

## 발급 방법

### 방법 1: Google AI Studio (권장)

1. **Google AI Studio 접속**
   - https://makersuite.google.com/app/apikey 접속
   - 또는 https://aistudio.google.com/app/apikey

2. **Google 계정으로 로그인**
   - Codebridge-Chatbot 프로젝트와 연결된 Google 계정 사용

3. **API 키 생성**
   - "Create API Key" 버튼 클릭
   - 프로젝트 선택: **Codebridge-Chatbot** (또는 원하는 프로젝트)
   - API 키가 생성되면 복사

4. **API 키 저장**
   - 생성된 API 키를 `apikey/gemini_api_key.txt` 파일에 저장
   - 파일에는 API 키만 저장 (설명 텍스트 제외)

### 방법 2: Google Cloud Console

1. **Google Cloud Console 접속**
   - https://console.cloud.google.com/ 접속
   - 프로젝트 선택: **Codebridge-Chatbot**

2. **API 활성화**
   - 왼쪽 메뉴: "API 및 서비스" > "라이브러리"
   - "Generative Language API" 검색
   - "사용 설정" 클릭

3. **API 키 생성**
   - "API 및 서비스" > "자격 증명"
   - "자격 증명 만들기" > "API 키"
   - 생성된 API 키 복사

4. **API 키 제한 설정 (권장)**
   - 생성된 API 키 클릭
   - "API 제한사항" 탭
   - "키 제한" 선택
   - "Generative Language API"만 허용
   - "저장" 클릭

5. **API 키 저장**
   - 생성된 API 키를 `apikey/gemini_api_key.txt` 파일에 저장

## API 키 형식

Gemini API 키는 일반적으로 다음과 같은 형식입니다:
- 길이: 약 39자
- 예시: `AIzaSyAbCdEfGhIjKlMnOpQrStUvWxYz1234567`

## 현재 사용 중인 모델

- **모델**: `gemini-2.5-flash-native-audio-preview-09-2025`
- **기능**: Live Audio (실시간 음성 대화)
- **SDK**: `@google/genai` (Google GenAI SDK)

## 확인 방법

API 키가 올바르게 설정되었는지 확인:

1. `apikey/gemini_api_key.txt` 파일 열기
2. API 키만 있는지 확인 (설명 텍스트 없음)
3. 브라우저에서 `ai_sam/index.php` 접속
4. "Call Sam" 버튼 클릭
5. 브라우저 콘솔(F12)에서 디버그 로그 확인

## 문제 해결

### API 키 오류가 발생하는 경우:

1. **API 키 형식 확인**
   - API 키가 올바른 형식인지 확인
   - 파일에 불필요한 공백이나 줄바꿈이 없는지 확인

2. **API 활성화 확인**
   - Google Cloud Console에서 "Generative Language API"가 활성화되어 있는지 확인

3. **프로젝트 확인**
   - Codebridge-Chatbot 프로젝트에서 API 키가 생성되었는지 확인

4. **할당량 확인**
   - Google Cloud Console에서 API 할당량이 남아있는지 확인

## 참고 링크

- Google AI Studio: https://makersuite.google.com/
- Google Cloud Console: https://console.cloud.google.com/
- Gemini API 문서: https://ai.google.dev/docs

