本指南介绍了如何开始使用适用于您所选平台的 Vertex AI in 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 控制台中,前往 Build with Gemini 页面。
点击 Vertex AI in Firebase 卡片可启动一个工作流,帮助您完成以下任务:
升级您的项目以使用随用随付 Blaze 定价方案。
在项目中启用所需的 API(Vertex AI API 和 Vertex AI in Firebase API)。
继续执行本指南中的下一步,将 SDK 添加到您的应用。
如果您还没有 Firebase 项目和与 Firebase 关联的应用
第 2 步:添加 SDK
设置完 Firebase 项目并将应用连接到 Firebase(请参阅上一步)后,您现在可以将 Vertex AI in Firebase SDK 添加到应用了。
使用 Swift Package Manager 安装和管理 Firebase 依赖项。
Vertex AI in Firebase 库提供对 Vertex AI Gemini API 的访问权限,包含在适用于 Apple 平台的 Firebase SDK (firebase-ios-sdk
) 中。
在 Xcode 中打开您的应用项目,依次点击 File(文件)> Add Packages(添加软件包)。
出现提示时,添加 Firebase Apple 平台 SDK 代码库:
https://github.com/firebase/firebase-ios-sdk
选择最新的 SDK 版本。
选择
FirebaseVertexAI
库。完成之后,Xcode 将会自动开始在后台解析和下载您的依赖项。
第 3 步:初始化 Vertex AI 服务和生成模型
您需要先初始化 Vertex AI 服务和生成式模型,然后才能进行任何 API 调用。
导入
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)
print(response.text ?? "No text in response.")
您还可以做些什么?
详细了解 Gemini 模型
了解适用于各种用例的模型及其配额和价格。
试用 Gemini API 的其他功能
- 详细了解如何根据纯文本提示生成文本,包括如何流式传输回答。
- 从多模态提示(包括文本、图片、PDF、视频和音频)生成文本。
- 构建多轮对话(聊天)。
- 根据文本和多模态提示生成结构化输出(如 JSON)。
- 使用函数调用将生成模型连接到外部系统和信息。
了解如何控制内容生成
您还可以使用 Vertex AI Studio 对提示和模型配置进行实验。就您使用 Vertex AI in Firebase 的体验提供反馈