Firebase의 Vertex AI SDK를 사용하여 Gemini API 시작하기


이 가이드에서는 선택한 플랫폼의 Vertex AI in Firebase SDK를 사용하여 앱에서 직접 Vertex AI Gemini API를 호출하는 방법을 설명합니다.

기본 요건

이 가이드에서는 사용자가 Xcode를 사용하여 Apple 플랫폼(예: iOS)용 앱을 개발하는 데 익숙하다고 가정합니다.

1단계: Firebase 프로젝트 설정 및 앱을 Firebase에 연결

Firebase 프로젝트와 Firebase에 연결된 앱이 이미 있는 경우

  1. Firebase 콘솔에서 Gemini로 빌드 페이지로 이동합니다.

  2. Vertex AI in Firebase 카드를 클릭하여 다음 작업을 완료하는 데 도움이 되는 워크플로를 실행합니다.

  3. 이 가이드의 다음 단계로 진행하여 앱에 SDK를 추가합니다.

아직 Firebase 프로젝트와 Firebase에 연결된 앱이 없는 경우


2단계: SDK 추가

Firebase 프로젝트가 설정되고 앱이 Firebase에 연결되면(이전 단계 참고) 이제 앱에 Vertex AI in Firebase SDK를 추가할 수 있습니다.

Swift Package Manager를 사용해 Firebase 종속 항목을 설치하고 관리하세요.

Vertex AI in Firebase 라이브러리는 Vertex AI Gemini API에 대한 액세스를 제공하며 Apple 플랫폼용 Firebase SDK (firebase-ios-sdk)의 일부로 포함되어 있습니다.

  1. 앱 프로젝트를 연 상태로 Xcode에서 File(파일) > Add Packages(패키지 추가)로 이동합니다.

  2. 메시지가 표시되면 Firebase Apple 플랫폼 SDK 저장소를 추가합니다.

      https://github.com/firebase/firebase-ios-sdk

  3. 최신 SDK 버전을 선택합니다.

  4. FirebaseVertexAI 라이브러리를 선택합니다.

    완료되면 Xcode가 백그라운드에서 자동으로 종속 항목을 확인하고 다운로드하기 시작합니다.

3단계: Vertex AI 서비스 및 생성형 모델 초기화

API를 호출하려면 먼저 Vertex AI 서비스와 생성 모델을 초기화해야 합니다.

  1. FirebaseVertexAI 모듈을 가져옵니다.

    import FirebaseVertexAI

  2. Vertex AI 서비스와 생성 모델을 초기화합니다.

    import FirebaseVertexAI

// Initialize the Vertex AI service
let vertex = VertexAI.vertexAI()

// Initialize the generative model with a model that supports your use case
let model = vertex.generativeModel(modelName: "gemini-2.0-flash")

시작 가이드를 완료한 후 사용 사례 및 앱에 적합한 Gemini 모델과 (선택사항) 위치를 선택하는 방법을 알아봅니다.

4단계: Vertex AI Gemini API 호출

이제 앱을 Firebase에 연결하고, SDK를 추가하고, Vertex AI 서비스와 생성형 모델을 초기화했으므로 Vertex AI Gemini API를 호출할 수 있습니다.

generateContent()를 사용하여 텍스트 전용 프롬프트 요청에서 텍스트를 생성할 수 있습니다.

import FirebaseVertexAI

// Initialize the Vertex AI service
let vertex = VertexAI.vertexAI()

// Initialize the generative model with a model that supports your use case
let model = vertex.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.")

또 뭘 할 수 있니?

Gemini 모델 자세히 알아보기

다양한 사용 사례에 사용할 수 있는 모델과 할당량 및 가격에 대해 알아보세요.

Gemini API의 다른 기능 사용해 보기

콘텐츠 생성을 제어하는 방법 알아보기

Vertex AI Studio를 사용하여 프롬프트 및 모델 구성을 실험할 수도 있습니다.


Vertex AI in Firebase 사용 경험에 관한 의견 보내기