透過 Firebase SDKs 的 Vertex AI AI 開始使用 Gemini'API


本指南說明如何開始使用所選平台的 Vertex AI in Firebase SDK，直接從應用程式呼叫 Vertex AI Gemini API。

請注意，您也可以使用這份指南，開始使用 Vertex AI in Firebase SDK 存取 Imagen 模型。

事前準備

本指南假設您熟悉使用 Xcode 為 Apple 平台 (例如 iOS) 開發應用程式。

  • 請確認您的開發環境和 Apple 平台應用程式符合下列規定：

    • Xcode 15.2 以上版本
    • 應用程式必須指定 iOS 15 以上版本，或 macOS 12 以上版本。

  • (選用) 查看範例應用程式。

    下載快速入門應用程式

    您可以快速試用 SDK、查看各種用途的完整實作方式，或使用範例應用程式 (如果您沒有自己的 Apple 平台應用程式)。如要使用範例應用程式，您必須將其連結至 Firebase 專案。

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

如果您已擁有 Firebase 專案和已連結至 Firebase 的應用程式

  1. 在 Firebase 控制台中，前往「Vertex AI」頁面。

  2. 按一下 Vertex AI in Firebase 資訊卡，即可啟動工作流程，協助您完成下列工作：

  3. 請繼續參閱本指南的後續步驟，將 SDK 新增至應用程式。

如果您「沒有」已建立 Firebase 專案，也沒有與 Firebase 連結的應用程式

  1. 登入 Firebase 控制台。

  2. 按一下「建立專案」，然後使用下列任一選項：

    • 選項 1：在「建立專案」工作流程的第一個步驟中輸入新專案名稱，即可建立全新的 Firebase 專案 (以及其底層 Google Cloud 專案)。

    • 選項 2：在現有的 Google Cloud 專案中「新增 Firebase」，方法是在「建立專案」工作流程的第一個步驟中，從下拉式選單中選取 Google Cloud 專案名稱。

    請注意，在系統提示時，您不需要設定 Google Analytics 來使用 Vertex AI in Firebase SDK。

  3. 在 Firebase 控制台中，前往「Vertex AI」頁面。

  4. 按一下 Vertex AI in Firebase 資訊卡，即可啟動工作流程，協助您完成下列工作：

  1. 繼續在主控台的生成式 AI 工作流程中，將應用程式連結至 Firebase，其中包括以下工作：

    • 透過 Firebase 專案註冊應用程式。

    • 將 Firebase 設定檔 (GoogleService-Info.plist) 新增至應用程式。

  2. 在本指南的後續步驟中，您將在應用程式中新增 Vertex AI in Firebase SDK，並完成使用 SDK 和 Gemini API 所需的初始化作業。


步驟 2：新增 SDK

Firebase 專案設定完成後，應用程式已連結至 Firebase (請參閱上一個步驟)，現在您可以將 Vertex AI in Firebase SDK 新增至應用程式。

使用 Swift Package Manager 安裝及管理 Firebase 依附元件。

Vertex AI in Firebase 程式庫提供 API 存取權，可用於與 Gemini 和 Imagen 模型互動。這個程式庫是 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 服務和生成式模型

您必須先初始化 Vertex AI 服務和生成模型，才能發出任何 API 呼叫並提示 Gemini 模型。

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

完成這份入門指南後，請瞭解如何選擇適合用途和應用程式的模型和 (選用) 位置。

步驟 4：向模型傳送提示要求

您已將應用程式連結至 Firebase、新增 SDK，並初始化 Vertex AI 服務和生成模型，因此可以向 Gemini 模型傳送提示要求。

您可以使用 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 API 的其他功能

瞭解如何控管內容產生

您也可以使用 Vertex AI Studio 來測試提示和模型設定。


提供使用 Vertex AI in Firebase 的意見回饋