Firebase AI Logic을 사용하는 Gemini API

Firebase AI Logic을 사용하여 Gemini 모델로 AI 기반 모바일 및 웹 앱과 기능 빌드

Firebase AI Logic을 사용하면 Google의 최신 생성형 AI 모델인 Gemini 모델에 액세스할 수 있습니다.

서버 측이 아닌 모바일 또는 웹 앱에서 직접 Gemini API을(를) 호출해야 하는 경우 Firebase AI Logic 클라이언트 SDK를 사용하면 됩니다. 이러한 클라이언트 SDK는 모바일 및 웹 앱에서 사용하도록 특별히 빌드되었으며, 승인되지 않은 클라이언트에 대한 보안 옵션과 다른 Firebase 서비스와의 통합을 제공합니다.

이러한 클라이언트 SDK는 Apple 플랫폼용 Swift, Android용 Kotlin 및 Java, 웹용 JavaScript, Flutter용 Dart, Unity에서 사용할 수 있습니다.

이러한 클라이언트 SDK를 사용하면 앱에 AI 맞춤설정을 추가하고, AI 채팅 환경을 빌드하고, AI 기반 최적화 및 자동화를 만드는 등 다양한 작업을 수행할 수 있습니다.

시작하기

주요 기능

멀티모달 및 자연어 입력 Gemini 모델은 멀티모달이므로 Gemini API로 전송되는 프롬프트에 텍스트, 이미지, PDF, 동영상, 오디오가 포함될 수 있습니다. 일부 Gemini 모델은 멀티모달 출력을 생성할 수도 있습니다.

Gemini 모델은 자연어 입력으로 프롬프트를 표시할 수 있습니다.

기능 모음 확장 SDK를 사용하면 모바일 또는 웹 앱에서 직접 Gemini API을 호출하여 AI 채팅 환경을 빌드하고, 이미지를 생성하고, 도구 (예: 함수 호출Google Search 또는 Google Maps 기반)를 사용하고, 멀티모달 입력 및 출력 (오디오 포함)을 스트리밍하는 등의 작업을 할 수 있습니다.
프로덕션 앱의 보안 및 악용 방지 Firebase App Check를 사용하여 승인되지 않은 클라이언트의 악용으로부터 Gemini 모델에 액세스하는 API를 보호하세요.

Firebase AI Logic에는 사용자별 속도 제한도 기본적으로 있으며, 이러한 사용자별 속도 제한은 완전히 구성 가능합니다.

강력한 인프라 모바일 및 웹 앱에서 사용하도록 빌드된 확장 가능한 인프라를 활용하세요. 예를 들어 파일 관리Cloud Storage for Firebase, Firebase 데이터베이스 제품(예: Cloud Firestore)으로 구조화된 데이터 관리, Firebase Remote Config으로 런타임 구성 동적 설정 등이 있습니다.

기본 원리

Firebase AI Logic은 클라이언트 SDK, 프록시 서비스, 기타 기능을 제공하여 Google의 생성형 AI 모델에 액세스하여 모바일 및 웹 앱에서 AI 기능을 빌드할 수 있도록 합니다.

Google 모델 및 "Gemini API" 제공업체 지원

최신 Gemini 모델을 모두 지원하며, 이러한 모델에 액세스하기 위해 선호하는 "Gemini API" 제공업체를 선택할 수 있습니다. Gemini Developer APIVertex AI Gemini API을 모두 지원합니다. 두 API 제공업체 사용의 차이점을 알아보세요.

Gemini Developer API을 사용하도록 선택하면 '무료 등급'을 활용하여 빠르게 시작하고 실행할 수 있습니다.

모바일 및 웹 클라이언트 SDK

Apple 플랫폼용 Swift, Android용 Kotlin & Java, 웹용 JavaScript, Flutter용 Dart, Unity에서 사용할 수 있는 Firebase AI Logic 클라이언트 SDK를 사용하여 모바일 또는 웹 앱에서 직접 모델에 요청을 보냅니다.

Firebase 프로젝트에 Gemini API 제공업체가 모두 설정되어 있는 경우 다른 API를 사용 설정하고 초기화 코드 몇 줄을 변경하기만 하면 API 제공업체 간에 전환할 수 있습니다.

또한 여러 클라이언트 SDK에서 하이브리드 및 온디바이스 추론에 액세스할 수 있습니다. 이 구성을 사용하면 앱에서 온디바이스 모델을 사용할 수 있지만 필요한 경우 클라우드 호스팅 모델로 원활하게 대체할 수 있습니다 (그 반대의 경우도 마찬가지).

프록시 서비스

Google의 프록시 서비스는 클라이언트와 선택한 Gemini API 제공업체 (및 Google의 모델) 간의 게이트웨이 역할을 합니다. 모바일 및 웹 앱에 중요한 서비스와 통합을 제공합니다. 예를 들어 설정하여 Firebase App Check선택한 API 제공업체와 백엔드 리소스를 승인되지 않은 클라이언트의 악용으로부터 보호할 수 있습니다.

프록시 서비스와 이 App Check 통합을 통해 Gemini API 키가 서버에 유지되고 앱의 코드베이스에 삽입되지 않도록 하기 때문에 Gemini Developer API를 사용하도록 선택한 경우 특히 중요합니다.

구현 경로

Firebase 프로젝트 설정 및 앱을 Firebase에 연결 Firebase AI Logic 페이지에 있는 안내 워크플로를 사용하여 프로젝트를 설정하고 (선택한 Gemini API 제공업체에 필요한 API 사용 설정 포함), 앱을 Firebase 프로젝트에 등록한 후 Firebase 구성을 앱에 추가합니다.Firebase
SDK 설치 및 초기화 앱의 플랫폼에 맞는 Firebase AI Logic SDK를 설치한 후 서비스 초기화 및 앱에서 모델 인스턴스를 만듭니다.
Gemini 모델에 프롬프트 요청 전송 SDK를 사용하여 텍스트 전용 또는 멀티모달 프롬프트를 Gemini 모델에 전송하여 텍스트 및 코드, 구조화된 출력 (예: JSON)이미지를 생성합니다.

다중 턴 채팅 양방향 스트리밍 (오디오 포함)함수 호출로 더 풍부한 환경을 빌드합니다.

프로덕션 준비 Firebase 앱 체크로 API를 악용으로부터 보호하고 Firebase 원격 구성을 사용하여 코드의 매개변수 (가장 중요한 모델 이름)를 원격으로 업데이트하는 등 모바일 및 웹 앱에 중요한 통합을 구현합니다.Firebase App CheckFirebase Remote Config

다음 단계

모바일 또는 웹 앱에서 모델 액세스 시작

시작 가이드로 이동

지원되는 모델 자세히 알아보기

다양한 사용 사례에 사용할 수 있는 모델할당량가격을 알아봅니다.