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


이 가이드에서는 Firebase용 Vertex AI SDK를 사용하여 앱에서 직접 Vertex AI Gemini API 호출을 시작하는 방법을 설명합니다.

기본 요건

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

  • 개발 환경 및 Apple 플랫폼 앱이 다음 요구사항을 충족하는지 확인합니다.

    • Xcode 15.0 이상
    • 앱이 iOS 15 이상 또는 macOS 12 이상을 타겟팅해야 합니다.

  • (선택사항) 샘플 앱을 확인합니다.

    샘플 앱 다운로드

    SDK를 빠르게 사용해 보거나, 다양한 사용 사례의 전체 구현을 살펴보거나, Apple 플랫폼 앱이 없는 경우 샘플 앱을 사용할 수 있습니다. 샘플 앱을 사용하려면 Firebase 프로젝트에 연결해야 합니다.

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

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

  1. Firebase Console에서 Gemini로 빌드 페이지로 이동한 후 두 번째 카드를 클릭하여 다음 작업을 수행하는 데 도움이 되는 워크플로를 시작합니다. Vertex AI 콘솔에 탭이 표시되면 이러한 작업이 완료된 것입니다

  2. 이 가이드의 다음 단계로 진행하여 앱에 SDK를 추가하세요.

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


2단계: SDK 추가

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

Firebase용 Vertex AI 라이브러리는 Vertex AI Gemini API에 대한 액세스를 제공하며 Apple 플랫폼용 Firebase SDK (firebase-ios-sdk)의 일부로 포함되어 있습니다. Firebase용 Vertex AI 라이브러리의 경우 Swift Package Manager를 사용하여 Firebase 종속 항목을 설치하고 관리해야 합니다. CocoaPods와 같은 다른 패키지 관리자는 현재 지원되지 않습니다.

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

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

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

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

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

    완료되면 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
// Gemini 1.5 models are versatile and can be used with all API capabilities
let model = vertex.generativeModel(modelName: "gemini-1.5-flash-preview-0514")

시작 가이드를 완료했다면 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
// Gemini 1.5 models are versatile and can be used with all API capabilities
let model = vertex.generativeModel(modelName: "gemini-1.5-flash-preview-0514")

// 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)
if let text = response.text {
  print(text)
}

가능한 작업

Gemini 모델 자세히 알아보기

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

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

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

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


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