SamProject/sam-kd
6
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
1d79a2989bd44a246d771bac0dcdcc4d8f4af0f4
sam-kd/ai_sam/API_KEY_GUIDE.md
hskwon aca1767eb9 초기 커밋: 5130 레거시 시스템 
- URL 하드코딩 → .env APP_URL 기반 동적 URL로 변경
- DB 연결 하드코딩 → .env 기반으로 변경
- MySQL strict mode DATE 오류 수정
2025-12-10 20:14:31 +09:00

3.0 KiB
Raw Blame History

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 접속

  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 접속

  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 할당량이 남아있는지 확인

참고 링크