hskwon
aca1767eb9
- URL 하드코딩 → .env APP_URL 기반 동적 URL로 변경 - DB 연결 하드코딩 → .env 기반으로 변경 - MySQL strict mode DATE 오류 수정
103 lines
3.0 KiB
Markdown
103 lines
3.0 KiB
Markdown
# 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
|
|
|