Firebase AI Logic, 이 플랜 아니면 절반만 됩니다

무료로 쓸 수 있다고 해서 시작했다가, Vertex AI 기능이 막혀 있다는 걸 나중에 알게 되는 경우가 많습니다. 공식 문서에서 직접 확인한 플랜별 차이와, 2026년 3월에 실제로 터진 모델 지원 중단 이슈를 같이 정리했습니다.

Firebase AI Logic이 뭔지, 이름부터 헷갈립니다

솔직히 말하면, 이름 때문에 처음 접하는 분들이 많이 헷갈립니다. Firebase AI Logic은 원래 ‘Vertex AI in Firebase’라는 이름으로 출시됐다가 2025년 5월에 리브랜딩된 SDK입니다. 공식 FAQ에도 딱 이렇게 나옵니다. “2024년 초 구글은 Vertex AI Gemini API를 Firebase에서 사용할 수 있도록 하는 Firebase SDK를 출시했으며, 이 SDK의 초기 이름은 ‘Vertex AI in Firebase’였습니다.”
(출처: Firebase AI Logic 공식 FAQ, firebase.google.com/docs/ai-logic/faq-and-troubleshooting)

이름이 바뀐 이유는 단순한 리브랜딩이 아닙니다. 2025년 5월 이후 Firebase App Check가 Gemini Developer API도 지원하게 되면서, SDK가 Vertex AI 전용에서 벗어나 두 가지 API 백엔드를 모두 지원하는 구조로 바뀌었습니다. 즉, 지금의 Firebase AI Logic은 Gemini Developer API와 Vertex AI Gemini API 중 하나를 선택해서 연결하는 통합 SDK입니다.

지원 플랫폼은 Swift(Apple), Kotlin/Java(Android), JavaScript(Web), Dart(Flutter), Unity로 총 5개입니다. 하나의 SDK 인터페이스로 클라이언트 앱에서 Gemini, Imagen 모델을 직접 호출할 수 있는 구조입니다.

▲ 목차로 돌아가기

Spark 플랜에서 막히는 기능이 생각보다 많습니다

Firebase AI Logic 공식 문서에는 “Firebase AI Logic은 무료입니다”라고 명시되어 있습니다. 엄밀히 말하면 절반은 맞고 절반은 다릅니다. Gemini Developer API 백엔드는 Spark 플랜(무료)에서도 사용 가능합니다. 그런데 Vertex AI Gemini API 백엔드는 Blaze 플랜(종량제 유료)이어야만 활성화됩니다.
(출처: Firebase AI Logic 공식 가격 문서, firebase.google.com/docs/ai-logic/pricing)

이게 실제로 어떤 의미냐면, Imagen 4로 이미지를 생성하거나 Cloud Storage URL을 멀티모달 입력으로 사용하거나, Firebase Security Rules로 파일 접근을 제어하려면 반드시 Blaze 플랜으로 업그레이드해야 합니다. Veo(영상 생성)도 현재 Vertex AI Gemini API에서만 지원됩니다. Spark 플랜에서는 Gemini 텍스트 생성과 이미지 분석 정도만 실용적으로 쓸 수 있습니다.

출처: Firebase AI Logic 공식 가격 및 FAQ 문서 (firebase.google.com/docs/ai-logic/pricing, firebase.google.com/docs/ai-logic/faq-and-troubleshooting)

▲ 목차로 돌아가기

Firebase AI Logic SDK는 두 가지 백엔드 중 하나를 초기화 시점에 선택합니다. GoogleAIBackend를 쓰면 Gemini Developer API, VertexAIBackend를 쓰면 Vertex AI Gemini API로 연결됩니다. 코드 한 줄 차이인데 요금 체계와 가용 기능이 완전히 달라집니다.

핵심 차이점 3가지

▲ 목차로 돌아가기

Preview 모델만 믿다가 4개월 작업이 날아간 실제 사례

2026년 3월 9일, Firebase AI Logic에서 지원하던 Gemini 3 Pro Preview(gemini-3-pro-preview)가 공식 지원 종료됐습니다. 공식 모델 문서에 지원 종료일이 ‘2026-03-09’로 명기돼 있습니다. (출처: firebase.google.com/docs/ai-logic/models)

문제는 Firebase Studio에서 이 모델이 UI상으로는 여전히 “Gemini 3 Pro Preview”로 표시된 채 남아 있었다는 점입니다. Reddit r/Firebase에 2026년 3월 14일 올라온 실제 사례를 보면, 한 개발자가 2024년 12월부터 4개월간 하루 10시간씩 개발한 앱 코드가 3월 9일 이후 AI 에이전트 오작동으로 이전 버전으로 되돌아갔고, 이를 복구하지 못하고 있다고 남겼습니다. 코드 버전 관리를 별도로 하지 않았기 때문에 더 큰 피해로 이어진 사례입니다.

Firebase AI Logic 공식 FAQ에는 모델 이름 오류나 404가 발생했을 때 “지원 중인 모델 이름 목록을 확인하라”고만 나와 있습니다. Preview 모델이 지원 종료될 때 사전 알림이나 마이그레이션 가이드를 자동으로 제공하는 공식 절차는 별도로 공개되지 않았습니다. 이 구조적 특성 때문에 Preview 모델을 프로덕션 앱에 그대로 쓰는 건 상당한 리스크가 있습니다.

▲ 목차로 돌아가기

2026.03.31 이전에 확인해야 할 Firebase AI Logic 모델 중단 목록

지금 당장 가장 급한 건 Gemini 2.0 Flash 계열 모델입니다. 공식 FAQ에는 이렇게 나와 있습니다. “Gemini 2.0 Flash 및 Gemini 2.0 Flash-Lite: 2026년 2월 6일 지원 중단 공지, 2026년 3월 31일 서비스 완전 종료.” 즉, 이 글이 올라오는 시점(2026.03.25)에서 6일 남은 상황입니다.
(출처: Firebase AI Logic 공식 FAQ — firebase.google.com/docs/ai-logic/faq-and-troubleshooting)

출처: Firebase AI Logic 공식 모델 문서 (firebase.google.com/docs/ai-logic/models), 2026.03.04 업데이트 기준

gemini-2.0-flash처럼 버전 날짜 없이 alias로 쓰는 방식은 자동으로 최신 버전을 따라가지 않습니다. 공식 문서에도 “alias는 특정 안정 버전을 가리키며, auto-updated가 아닌 경우 지원 종료 후 404가 발생한다”고 나와 있습니다. 안정적인 운영을 위해서는 버전 명기 없는 alias를 피하고, Firebase Remote Config로 모델명을 관리하는 방식이 현실적입니다.

▲ 목차로 돌아가기

Firebase AI Logic vs Genkit, 어느 쪽을 써야 하나요

Firebase AI Logic 공식 문서에는 이런 안내가 나옵니다. “서버 측 AI 기능이 필요하거나 OpenAI, Anthropic 등 다양한 AI 공급자를 함께 쓰려면 Genkit을 사용하라.” 반면 Firebase AI Logic SDK는 클라이언트 앱(모바일, 웹)에서 서버 없이 직접 AI에 접근하는 구조에 최적화돼 있습니다. (출처: firebase.google.com/docs/ai-logic)

앱 안에서 바로 Gemini를 호출해 텍스트·이미지 기능을 붙이고 싶다면 Firebase AI Logic SDK가 맞습니다. 반면 여러 AI 모델을 조합하거나 복잡한 에이전트 로직을 구성하려면 Genkit이 적합합니다. 두 가지를 동시에 쓰는 것도 가능하며, Firebase는 공식 문서에서 이를 배제하지 않습니다.

▲ 목차로 돌아가기

Q&A

▲ 목차로 돌아가기

마치며

Firebase AI Logic은 설정이 단순하고 클라이언트 앱에서 바로 Gemini를 붙일 수 있다는 점에서 실용적인 SDK입니다. 그런데 Spark 플랜 한계, Preview 모델 지원 종료 구조, Gemini Developer API와 Vertex AI Gemini API의 기능 차이 같은 부분은 공식 문서를 직접 파고들기 전에는 잘 눈에 안 들어오는 것들입니다.

특히 Preview 모델을 프로덕션에 그대로 쓰는 패턴은, 실제로 개발자가 피해를 입은 사례가 이미 나온 상황입니다. Firebase Remote Config를 이용해 모델명을 앱 외부에서 관리하는 방식이 Firebase 공식 문서에서도 권장하는 접근입니다. 기능보다 안정성을 먼저 챙겨야 할 구조입니다.

2026.03.31 이전에 gemini-2.0-flash 계열을 쓰고 있다면 지금 바로 모델 목록 페이지를 열어보는 게 맞습니다.

▲ 목차로 돌아가기

본 포스팅 참고 자료

1. Firebase AI Logic 공식 개요 — firebase.google.com/docs/ai-logic
2. Firebase AI Logic 지원 모델 목록 — firebase.google.com/docs/ai-logic/models
3. Firebase AI Logic FAQ 및 문제 해결 — firebase.google.com/docs/ai-logic/faq-and-troubleshooting
4. Firebase AI Logic 가격 정책 — firebase.google.com/docs/ai-logic/pricing
5. Firebase AI Logic 할당량 및 한도 — firebase.google.com/docs/ai-logic/quotas