通过 Vertex AI in Firebase SDK 开始使用 Gemini API


本指南将为您介绍如何开始调用 Vertex AI Gemini API Vertex AI in Firebase SDK（适用于您所选平台）。

前提条件

本指南假定您熟悉使用 Xcode 开发适用于 Apple 平台（例如 iOS）。

  • 请确保您的开发环境和 Apple 平台应用符合 以下要求：

    • Xcode 15.0 或更高版本
    • 您的应用必须以 iOS 15 或更高版本、macOS 12 或更高版本为目标平台。

  • （可选）查看示例应用。

    下载示例应用

    您可以快速试用该 SDK，并查看各种用法的完整实现。 或使用示例应用（如果您没有自己的 Apple 平台应用）。 要使用示例应用，您需要： 将其关联到 Firebase 项目。

第 1 步：设置一个 Firebase 项目，并将您的应用关联到 Firebase

如果您已有 Firebase 项目和已关联到 Firebase 的应用

  1. 在 Firebase 控制台中，前往 Build with Gemini 页面。

  2. 点击Vertex AI in Firebase卡片即可启动一个工作流程来帮助您 完成以下任务。（请注意，如果您在控制台中看到 Vertex AI，那么这些任务就完成了。）

  3. 继续执行本指南中的下一步，将 SDK 添加到您的应用中。

如果您还没有将 Firebase 项目和应用与 Firebase 相关联


第 2 步：添加 SDK

设置好 Firebase 项目并将应用关联到 Firebase 后 （参见上一步），您现在可以将 Vertex AI in Firebase SDK 添加到您的应用。

借助 Vertex AI in Firebase 库，您可以访问 Vertex AI Gemini API并作为 Firebase SDK 的一部分包含在内， Apple 平台 (firebase-ios-sdk)。对于 Vertex AI in Firebase 库， 您必须使用 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 服务和生成模型

您需要先初始化 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)
}
<ph type="x-smartling-placeholder">。 。

您还可以做些什么？

详细了解 Gemini 模型

详细了解 适用于各种应用场景的模型 及其 配额和定价。

试用Gemini API的其他功能

了解如何控制内容生成

。 您还可以使用以下方法对提示和模型配置进行实验： Vertex AI Studio。


提供反馈 分享您对Vertex AI in Firebase的体验