本指南介绍了如何开始使用 Vertex AI for Firebase SDK 从您的应用中直接调用 Vertex AI Gemini API。
前提条件
本指南假定您熟悉使用 Xcode 开发适用于 Apple 平台(如 iOS)的应用。
确保您的开发环境和 Apple 平台应用满足以下要求:
- Xcode 15.0 或更高版本
- 您的应用必须以 iOS 15 或更高版本、macOS 12 或更高版本为目标平台。
(可选)查看示例应用。
您可以快速试用 SDK,查看各种用例的完整实现,或者使用示例应用(如果您没有自己的 Apple 平台应用)。如需使用示例应用,您需要将其关联到 Firebase 项目。
第 1 步:设置一个 Firebase 项目,并将您的应用关联到 Firebase
如果您已有 Firebase 项目和已关联到 Firebase 的应用
在 Firebase 控制台中,前往“使用 Gemini 构建”页面,然后点击第二张卡片,启动可帮助您执行以下任务的工作流。如果您在控制台中看到 Vertex AI 的标签页,则表示这些任务已完成。
升级您的项目以使用 Blaze 随用随付定价方案。
为您的项目启用以下两个 API:
aiplatform.googleapis.com
和firebaseml.googleapis.com
。
继续执行本指南中的下一步,将 SDK 添加到您的应用中。
如果您还没有将 Firebase 项目和应用与 Firebase 相关联
第 2 步:添加 SDK
设置 Firebase 项目并将应用关联到 Firebase(请参阅上一步),您现在可以将 Vertex AI for Firebase SDK 添加到您的应用。
Vertex AI for Firebase 库提供对 Vertex AI Gemini API 的访问权限,包含在适用于 Apple 平台的 Firebase SDK (firebase-ios-sdk
) 中。对于 Vertex AI for Firebase 库,您必须使用 Swift Package Manager 安装和管理 Firebase 依赖项。目前不支持其他软件包管理器,例如 CocoaPods。
在 Xcode 中打开您的应用项目,依次点击 File(文件)> Add Packages(添加软件包)。
出现提示时,添加 Firebase Apple 平台 SDK 代码库:
https://github.com/firebase/firebase-ios-sdk
选择最新的 SDK 版本。
选择
FirebaseVertexAI-Preview
库。完成之后,Xcode 将会自动开始在后台解析和下载您的依赖项。
第 3 步:初始化 Vertex AI 服务和生成模型
在进行任何 API 调用之前,您需要初始化 Vertex AI 服务和生成模型。
导入
FirebaseVertexAI
模块:import FirebaseVertexAI
初始化 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 使用体验提供反馈