이 가이드에서는 선택한 플랫폼의 Firebase AI Logic 클라이언트 SDK를 사용하여 앱에서 직접 Gemini API를 호출하는 방법을 설명합니다.
이 가이드를 사용하여 Firebase AI Logic SDK를 사용하여 Imagen 모델에 액세스하는 작업을 시작할 수도 있습니다.
기본 요건
Swift
이 가이드에서는 사용자가 Xcode를 사용하여 Apple 플랫폼(예: iOS)용 앱을 개발하는 데 익숙하다고 가정합니다.
개발 환경과 Apple 플랫폼 앱이 다음 요구사항을 충족하는지 확인합니다.
- Xcode 16.2 이상
- 앱이 iOS 15 이상 또는 macOS 12 이상을 타겟팅하는 경우
(선택사항) 샘플 앱을 확인합니다.
SDK를 빠르게 사용해 보거나 다양한 사용 사례의 전체 구현을 확인하거나 자체 Apple 플랫폼 앱이 없는 경우 샘플 앱을 사용할 수 있습니다. 샘플 앱을 사용하려면 Firebase 프로젝트에 연결해야 합니다.
Kotlin
이 가이드에서는 Android 스튜디오를 사용하여 Android용 앱을 개발하는 데 익숙하다고 가정합니다.
개발 환경과 Android 앱이 다음 요구사항을 충족하는지 확인합니다.
- Android 스튜디오 (최신 버전)
- 앱이 API 수준 21 이상을 타겟팅하는 경우
(선택사항) 샘플 앱을 확인합니다.
SDK를 빠르게 사용해 보거나 다양한 사용 사례의 전체 구현을 확인하거나 자체 Android 앱이 없는 경우 샘플 앱을 사용할 수 있습니다. 샘플 앱을 사용하려면 Firebase 프로젝트에 연결해야 합니다.
Java
이 가이드에서는 Android 스튜디오를 사용하여 Android용 앱을 개발하는 데 익숙하다고 가정합니다.
개발 환경과 Android 앱이 다음 요구사항을 충족하는지 확인합니다.
- Android 스튜디오 (최신 버전)
- 앱이 API 수준 21 이상을 타겟팅하는 경우
(선택사항) 샘플 앱을 확인합니다.
SDK를 빠르게 사용해 보거나 다양한 사용 사례의 전체 구현을 확인하거나 자체 Android 앱이 없는 경우 샘플 앱을 사용할 수 있습니다. 샘플 앱을 사용하려면 Firebase 프로젝트에 연결해야 합니다.
Web
이 가이드에서는 독자가 JavaScript를 사용하여 웹 앱을 개발하는 데 익숙하다고 가정합니다. 이 가이드는 프레임워크와 무관합니다.
개발 환경과 웹 앱이 다음 요구사항을 충족하는지 확인합니다.
- (선택사항) Node.js
- 최신 웹브라우저
(선택사항) 샘플 앱을 확인합니다.
SDK를 빠르게 사용해 보거나 다양한 사용 사례의 전체 구현을 확인하거나 자체 웹 앱이 없는 경우 샘플 앱을 사용할 수 있습니다. 샘플 앱을 사용하려면 Firebase 프로젝트에 연결해야 합니다.
Dart
이 가이드에서는 독자가 Flutter로 앱을 개발하는 데 익숙하다고 가정합니다.
개발 환경과 Flutter 앱이 다음 요구사항을 충족하는지 확인합니다.
- Dart 3.2.0 이상
(선택사항) 샘플 앱을 확인합니다.
SDK를 빠르게 사용해 보거나 다양한 사용 사례의 전체 구현을 확인하거나 자체 Flutter 앱이 없는 경우 샘플 앱을 사용할 수 있습니다. 샘플 앱을 사용하려면 Firebase 프로젝트에 연결해야 합니다.
Unity
이 가이드에서는 독자가 Unity로 게임을 개발하는 데 익숙하다고 가정합니다.
개발 환경과 Unity 게임이 다음 요구사항을 충족하는지 확인합니다.
- Unity Editor 2021 LTS 이상
(선택사항) 샘플 앱을 확인합니다.
SDK를 빠르게 사용해 보거나 다양한 사용 사례의 전체 구현을 확인하거나 자체 Unity 게임이 없는 경우 샘플 앱을 사용할 수 있습니다. 샘플 앱을 사용하려면 Firebase 프로젝트에 연결해야 합니다.
1단계: Firebase 프로젝트 설정 및 앱 연결
Firebase 콘솔에 로그인한 후 Firebase 프로젝트를 선택합니다.
Firebase 콘솔에서 Firebase AI Logic 페이지로 이동합니다.
시작하기를 클릭하여 프로젝트에 필요한 API 및 리소스를 설정하는 데 도움이 되는 안내 워크플로를 시작합니다.
Firebase AI Logic SDK와 함께 사용할 'Gemini API' 제공업체를 선택합니다. 원하는 경우 나중에 언제든지 다른 API 제공업체를 설정하고 사용할 수 있습니다.
Console의 워크플로에서 메시지가 표시되면 화면에 표시된 안내에 따라 앱을 등록하고 Firebase에 연결합니다.
이 가이드의 다음 단계로 진행하여 앱에 SDK를 추가합니다.
2단계: SDK 추가
Firebase 프로젝트가 설정되고 앱이 Firebase에 연결되면(이전 단계 참고) 이제 앱에 Firebase AI Logic SDK를 추가할 수 있습니다.
Swift
Swift Package Manager를 사용해 Firebase 종속 항목을 설치하고 관리하세요.
Firebase AI Logic 라이브러리는 Gemini 및 Imagen 모델과 상호작용하는 API에 대한 액세스를 제공합니다. 이 라이브러리는 Apple 플랫폼용 Firebase SDK (firebase-ios-sdk
)의 일부로 포함되어 있습니다.
이미 Firebase를 사용하고 있다면 Firebase 패키지가 v11.13.0 이상인지 확인합니다.
앱 프로젝트를 연 상태로 Xcode에서 File(파일) > Add Package Dependencies(패키지 종속 항목 추가)로 이동합니다.
메시지가 표시되면 Firebase Apple 플랫폼 SDK 저장소를 추가합니다.
https://github.com/firebase/firebase-ios-sdk
최신 SDK 버전을 선택합니다.
FirebaseAI
라이브러리를 선택합니다.
완료되면 Xcode가 백그라운드에서 자동으로 종속 항목을 확인하고 다운로드하기 시작합니다.
Kotlin
Android용 Firebase AI Logic SDK (firebase-ai
)는 Gemini 및 Imagen 모델과 상호작용하는 API에 대한 액세스를 제공합니다.
모듈 (앱 수준) Gradle 파일(예: <project>/<app-module>/build.gradle.kts
)에서 Android용 Firebase AI Logic 라이브러리의 종속 항목을 추가합니다.
라이브러리 버전 관리 제어에는 Firebase Android BoM을 사용하는 것이 좋습니다.
dependencies { // ... other androidx dependencies // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:33.14.0")) // Add the dependency for the Firebase AI Logic library // When using the BoM, you don't specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-ai") }
Firebase Android BoM을 사용하면 앱에서 항상 호환되는 Firebase Android 라이브러리 버전을 사용합니다.
Java
Android용 Firebase AI Logic SDK (firebase-ai
)는 Gemini 및 Imagen 모델과 상호작용하는 API에 대한 액세스를 제공합니다.
모듈 (앱 수준) Gradle 파일(예: <project>/<app-module>/build.gradle.kts
)에서 Android용 Firebase AI Logic 라이브러리의 종속 항목을 추가합니다.
라이브러리 버전 관리 제어에는 Firebase Android BoM을 사용하는 것이 좋습니다.
Java의 경우 라이브러리를 두 개 더 추가해야 합니다.
dependencies { // ... other androidx dependencies // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:33.14.0")) // Add the dependency for the Firebase AI Logic library // When using the BoM, you don't specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-ai") // Required for one-shot operations (to use `ListenableFuture` from Guava Android) implementation("com.google.guava:guava:31.0.1-android") // Required for streaming operations (to use `Publisher` from Reactive Streams) implementation("org.reactivestreams:reactive-streams:1.0.4") }
Firebase Android BoM을 사용하면 앱에서 항상 호환되는 Firebase Android 라이브러리 버전을 사용합니다.
Web
Firebase AI Logic 라이브러리는 Gemini 및 Imagen 모델과 상호작용하는 API에 대한 액세스를 제공합니다. 이 라이브러리는 웹용 Firebase JavaScript SDK의 일부로 포함되어 있습니다.
npm을 사용하여 웹용 Firebase JS SDK를 설치합니다.
npm install firebase
앱에서 Firebase를 초기화합니다.
import { initializeApp } from "firebase/app"; // TODO(developer) Replace the following with your app's Firebase configuration // See: https://firebase.google.com/docs/web/learn-more#config-object const firebaseConfig = { // ... }; // Initialize FirebaseApp const firebaseApp = initializeApp(firebaseConfig);
Dart
Flutter용 Firebase AI Logic 플러그인 (firebase_ai
)은 Gemini 및 Imagen 모델과 상호작용하는 API에 대한 액세스를 제공합니다.
Flutter 프로젝트 디렉터리에서 다음 명령어를 실행하여 core 플러그인과 Firebase AI Logic 플러그인을 설치합니다.
flutter pub add firebase_core && flutter pub add firebase_ai
lib/main.dart
파일에서 Firebase 핵심 플러그인, Firebase AI Logic 플러그인, 앞에서 생성한 구성 파일을 가져옵니다.import 'package:firebase_core/firebase_core.dart'; import 'package:firebase_ai/firebase_ai.dart'; import 'firebase_options.dart';
또한
lib/main.dart
파일에서 구성 파일로 내보낸DefaultFirebaseOptions
객체를 사용하여 Firebase를 초기화합니다.await Firebase.initializeApp( options: DefaultFirebaseOptions.currentPlatform, );
Flutter 애플리케이션을 다시 빌드합니다.
flutter run
Unity
Firebase Unity SDK를 다운로드한 후 원하는 위치에 SDK를 추출합니다.
Firebase Unity SDK는 플랫폼별로 제공되지 않습니다.
Unity 프로젝트를 열고 Assets(애셋) > Import Package(패키지 가져오기) > Custom Package(커스텀 패키지)로 이동합니다.
추출된 SDK에서
FirebaseAI
패키지를 선택합니다.Unity 패키지 가져오기 창에서 가져오기를 클릭합니다.
Firebase 콘솔로 돌아가서 설정 워크플로에서 다음을 클릭합니다.
3단계: 서비스를 초기화하고 모델 인스턴스 만들기
Gemini API 제공업체를 클릭하여 이 페이지에서 제공업체별 콘텐츠와 코드를 확인합니다. |
Gemini Developer API와 함께 Firebase AI Logic 클라이언트 SDK를 사용하는 경우 Gemini API 키를 앱의 코드베이스에 추가하지 않습니다. 자세히 알아보기
Gemini 모델에 프롬프트를 보내기 전에 선택한 API 제공업체의 서비스를 초기화하고 GenerativeModel
인스턴스를 만듭니다.
Swift
import FirebaseAI
// Initialize the Gemini Developer API backend service
let ai = FirebaseAI.firebaseAI(backend: .googleAI())
// Create a `GenerativeModel` instance with a model that supports your use case
let model = ai.generativeModel(modelName: "gemini-2.0-flash")
Kotlin
// Initialize the Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
val model = Firebase.ai(backend = GenerativeBackend.googleAI())
.generativeModel("gemini-2.0-flash")
Java
// Initialize the Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.googleAI())
.generativeModel("gemini-2.0-flash");
// Use the GenerativeModelFutures Java compatibility layer which offers
// support for ListenableFuture and Publisher APIs
GenerativeModelFutures model = GenerativeModelFutures.from(ai);
Web
import { initializeApp } from "firebase/app";
import { getAI, getGenerativeModel, GoogleAIBackend } from "firebase/ai";
// TODO(developer) Replace the following with your app's Firebase configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
// ...
};
// Initialize FirebaseApp
const firebaseApp = initializeApp(firebaseConfig);
// Initialize the Gemini Developer API backend service
const ai = getAI(firebaseApp, { backend: new GoogleAIBackend() });
// Create a `GenerativeModel` instance with a model that supports your use case
const model = getGenerativeModel(ai, { model: "gemini-2.0-flash" });
Dart
import 'package:firebase_ai/firebase_ai.dart';
import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';
// Initialize FirebaseApp
await Firebase.initializeApp(
options: DefaultFirebaseOptions.currentPlatform,
);
// Initialize the Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
final model =
FirebaseAI.googleAI().generativeModel(model: 'gemini-2.0-flash');
Unity
using Firebase;
using Firebase.AI;
// Initialize the Gemini Developer API backend service
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.GoogleAI());
// Create a `GenerativeModel` instance with a model that supports your use case
var model = ai.GetGenerativeModel(modelName: "gemini-2.0-flash");
사용 중인 기능에 따라 GenerativeModel
인스턴스가 항상 생성되지 않을 수 있습니다.
- Imagen 모델에 액세스하려면
ImagenModel
인스턴스를 만듭니다.
또한 이 시작 가이드를 완료한 후 사용 사례 및 앱에 적합한 모델을 선택하는 방법을 알아보세요.
4단계: 모델에 프롬프트 요청 전송
이제 Gemini 모델에 프롬프트 요청을 전송할 수 있습니다.
generateContent()
를 사용하여 텍스트가 포함된 프롬프트에서 텍스트를 생성할 수 있습니다.
Swift
import FirebaseAI
// Initialize the Gemini Developer API backend service
let ai = FirebaseAI.firebaseAI(backend: .googleAI())
// Create a `GenerativeModel` instance with a model that supports your use case
let model = ai.generativeModel(modelName: "gemini-2.0-flash")
// Provide a prompt that contains text
let prompt = "Write a story about a magic backpack."
// To generate text output, call generateContent with the text input
let response = try await model.generateContent(prompt)
print(response.text ?? "No text in response.")
Kotlin
Kotlin의 경우 이 SDK의 메서드는 정지 함수이므로 코루틴 범위에서 호출해야 합니다.
// Initialize the Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
val model = Firebase.ai(backend = GenerativeBackend.googleAI())
.generativeModel("gemini-2.0-flash")
// Provide a prompt that contains text
val prompt = "Write a story about a magic backpack."
// To generate text output, call generateContent with the text input
val response = generativeModel.generateContent(prompt)
print(response.text)
Java
Java의 경우 이 SDK의 메서드는ListenableFuture
를 반환합니다.
// Initialize the Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.googleAI())
.generativeModel("gemini-2.0-flash");
// Use the GenerativeModelFutures Java compatibility layer which offers
// support for ListenableFuture and Publisher APIs
GenerativeModelFutures model = GenerativeModelFutures.from(ai);
// Provide a prompt that contains text
Content prompt = new Content.Builder()
.addText("Write a story about a magic backpack.")
.build();
// To generate text output, call generateContent with the text input
ListenableFuture<GenerateContentResponse> response = model.generateContent(prompt);
Futures.addCallback(response, new FutureCallback<GenerateContentResponse>() {
@Override
public void onSuccess(GenerateContentResponse result) {
String resultText = result.getText();
System.out.println(resultText);
}
@Override
public void onFailure(Throwable t) {
t.printStackTrace();
}
}, executor);
Web
import { initializeApp } from "firebase/app";
import { getAI, getGenerativeModel, GoogleAIBackend } from "firebase/ai";
// TODO(developer) Replace the following with your app's Firebase configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
// ...
};
// Initialize FirebaseApp
const firebaseApp = initializeApp(firebaseConfig);
// Initialize the Gemini Developer API backend service
const ai = getAI(firebaseApp, { backend: new GoogleAIBackend() });
// Create a `GenerativeModel` instance with a model that supports your use case
const model = getGenerativeModel(ai, { model: "gemini-2.0-flash" });
// Wrap in an async function so you can use await
async function run() {
// Provide a prompt that contains text
const prompt = "Write a story about a magic backpack."
// To generate text output, call generateContent with the text input
const result = await model.generateContent(prompt);
const response = result.response;
const text = response.text();
console.log(text);
}
run();
Dart
import 'package:firebase_ai/firebase_ai.dart';
import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';
// Initialize FirebaseApp
await Firebase.initializeApp(
options: DefaultFirebaseOptions.currentPlatform,
);
// Initialize the Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
final model =
FirebaseAI.googleAI().generativeModel(model: 'gemini-2.0-flash');
// Provide a prompt that contains text
final prompt = [Content.text('Write a story about a magic backpack.')];
// To generate text output, call generateContent with the text input
final response = await model.generateContent(prompt);
print(response.text);
Unity
using Firebase;
using Firebase.AI;
// Initialize the Gemini Developer API backend service
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.GoogleAI());
// Create a `GenerativeModel` instance with a model that supports your use case
var model = ai.GetGenerativeModel(modelName: "gemini-2.0-flash");
// Provide a prompt that contains text
var prompt = "Write a story about a magic backpack.";
// To generate text output, call GenerateContentAsync with the text input
var response = await model.GenerateContentAsync(prompt);
UnityEngine.Debug.Log(response.Text ?? "No text in response.");
또 뭘 할 수 있니?
지원되는 모델 자세히 알아보기
다양한 사용 사례에 사용할 수 있는 모델과 할당량, 가격에 대해 알아보세요.
다른 기능 사용해 보기
- 응답을 스트리밍하는 방법을 비롯하여 텍스트 전용 프롬프트에서 텍스트를 생성하는 방법을 자세히 알아보세요.
- 이미지, PDF, 동영상, 오디오와 같은 다양한 파일 형식으로 프롬프트를 통해 텍스트를 생성합니다.
- 멀티턴 대화 (채팅)를 빌드합니다.
- 텍스트 및 멀티모달 프롬프트에서 구조화된 출력 (예: JSON)을 생성합니다.
- 텍스트 프롬프트에서 이미지를 생성합니다.
- Gemini Live API를 사용하여 입력 및 출력 (오디오 포함)을 스트리밍합니다.
- 함수 호출을 사용하여 생성형 모델을 외부 시스템 및 정보에 연결합니다.
콘텐츠 생성을 제어하는 방법 알아보기
- 권장사항, 전략, 프롬프트 예시를 포함하여 프롬프트 설계 이해하기
- 온도 및 최대 출력 토큰 (Gemini의 경우) 또는 가로세로 비율 및 사용자 생성 (Imagen의 경우)과 같은 모델 매개변수를 구성합니다.
- 안전 설정을 사용하여 유해하다고 간주될 수 있는 대답을 받을 가능성을 조정합니다.
Firebase AI Logic 사용 경험에 관한 의견 보내기