Firebase AI Logic (Gemini API) 웹/모바일 앱 네이티브 통합 튜토리얼

Firebase AI Logic (Vertex AI for Firebase) 소개

클라이언트 사이드 웹이나 모바일 앱에서 Gemini API를 호출할 때 가장 큰 문제는 API Key 유출 위험입니다.

Firebase AI Logic은 Firebase App Check 및 IAM 인증을 기반으로, API Key를 클라이언트에 노출하지 않고 안전하게 Gemini 1.5 모델을 모바일/웹 앱에 직접 연동하도록 지원합니다.

JavaScript / Web SDK 연동 코드 예시

import { initializeApp } from "firebase/app";
import { getVertexAI, getGenerativeModel } from "firebase/vertexai";

const firebaseConfig = {
  apiKey: "YOUR_FIREBASE_API_KEY",
  authDomain: "your-app.firebaseapp.com",
  projectId: "your-app-id"
};

// 1. Firebase 앱 및 Vertex AI 서비스 초기화
const app = initializeApp(firebaseConfig);
const vertexAI = getVertexAI(app);

// 2. Gemini 1.5 Flash 모델 인스턴스 생성
const model = getGenerativeModel(vertexAI, { model: "gemini-1.5-flash" });

// 3. 인텔리전트 텍스트 생성
async function askAI(prompt) {
  const result = await model.generateContent(prompt);
  console.log(result.response.text());
}

💡 핵심 Gemini AI 용어 사전 (Glossary)

• Firebase AI Logic: Firebase 플랫폼 환경에서 Gemini API 및 Vertex AI 모델을 보안 인증을 거쳐 안전하게 사용할 수 있도록 지원하는 라이브러리.
• App Check: 악성 클라이언트나 매크로 봇이 내 API 자원을 무단 도용하는 것을 사전 방지하는 Firebase의 앱 보안 검증 서비스.
• Client SDK: 웹 브라우저나 iOS/Android 앱 환경에서 직접 서버 서비스에 연결할 수 있도록 제공하는 라이브러리.

Firebase AI 연동 체크리스트

• [ ] Firebase App Check가 활성화되어 유효한 요청만 처리하고 있는가?
• [ ] 사용량 과금을 방지하기 위한 Daily Quota 제한이 설정되었는가?