透過 Vertex AI for Firebase SDK 開始使用 Gemini API


本指南說明如何開始呼叫 直接在應用程式中使用 Vertex AI Gemini API Vertex AI for Firebase SDK

事前準備

本指南假設您已熟悉如何使用 Xcode 開發 Apple 平台 (例如 iOS)。

  • 請確保您的開發環境和 Apple 平台應用程式符合 符合以下條件:

    • Xcode 15.0 以上版本
    • 您的應用程式必須指定 iOS 15 以上版本或 macOS 12 以上版本。
  • (選用) 查看範例應用程式。

    下載範例應用程式

    您可以快速試用 SDK,查看各種用途的完整導入方式 。如果沒有自己的 Apple 平台應用程式,也可使用範例應用程式。 如要使用範例應用程式,您必須完成以下工作: 將其連結至 Firebase 專案

步驟 1:設定 Firebase 專案並將應用程式連結至 Firebase

如果您已經有 Firebase 專案,且有一個應用程式連結至 Firebase

  1. 在 Firebase 控制台中,前往 運用 Gemini 建構內容頁面: 然後按一下第二張資訊卡,啟動工作流程 來記錄這些資料如果您在控制台中看到 Vertex AI 的分頁, 這些工作在完成時

  2. 請繼續進行本指南的下一步驟,將 SDK 加入應用程式。

如果您尚未有 Firebase 專案,且有一個應用程式連結至 Firebase


步驟 2:新增 SDK

設定 Firebase 專案,並將應用程式連結至 Firebase (請參閱上一個步驟),您可以將 Vertex AI for Firebase SDK 新增至應用程式。

有了 Vertex AI for Firebase 程式庫,您就能存取 Vertex AI Gemini API,包含在 Firebase SDK 中 Apple 平台 (firebase-ios-sdk)。在 Vertex AI for Firebase 程式庫中 您必須使用 Swift Package Manager 安裝及管理 Firebase 依附元件其他套件管理工具 (如 CocoaPods) 目前 支援。

  1. 在 Xcode 中保持開啟應用程式專案,然後依序選擇 [檔案] >新增套件

  2. 在系統提示時,新增 Firebase Apple 平台 SDK 存放區:

      https://github.com/firebase/firebase-ios-sdk
    
  3. 選取最新的 SDK 版本。

  4. 選取 FirebaseVertexAI-Preview 程式庫。

    完成後,Xcode 會自動開始解析並下載 複製到背景依附元件

步驟 3:初始化 Vertex AI 服務和生成式模型

您必須先初始化 Vertex AI,才能發出 API 呼叫 以及生成式模型

  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")
    

閱讀完入門指南後,請瞭解如何選擇 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")

// 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


提供意見 您對 Vertex AI for Firebase 的使用體驗