本指南将为您介绍如何开始调用 Vertex AI Gemini API Vertex AI in Firebase SDK(适用于您所选平台)。
前提条件
本指南假定您熟悉 Flutter 应用的开发。
确保您的开发环境和 Flutter 应用符合以下要求 要求:
- Dart 3.2.0 及更高版本
(可选)查看示例应用。
您可以快速试用该 SDK,查看各种用法的完整实现。 或使用示例应用(如果您没有自己的 Flutter 应用)。 要使用示例应用,您需要: 将其关联到 Firebase 项目。
第 1 步:设置一个 Firebase 项目,并将您的应用关联到 Firebase
如果您已有 Firebase 项目和已关联到 Firebase 的应用
在 Firebase 控制台中,前往 Build with Gemini 页面中, 然后点击第二张卡片启动工作流程 后续任务。如果您在控制台中看到 Vertex AI 的标签页,则 这些任务都已完成。
升级您的项目以使用 Blaze 随用随付定价方案。
为您的项目启用以下两个 API:
aiplatform.googleapis.com
和firebaseml.googleapis.com
。
继续执行本指南中的下一步,将 SDK 添加到您的应用中。
如果您还没有将 Firebase 项目和应用与 Firebase 相关联
第 2 步:添加 SDK
设置好 Firebase 项目并将应用关联到 Firebase 后 (参见上一步),您现在可以将 Vertex AI in Firebase SDK 添加到您的应用。
适用于 Flutter 的 Vertex AI in Firebase 插件 (firebase_vertexai
) 提供
对 Vertex AI Gemini API 的访问权限。
从 Flutter 项目目录运行以下命令: 安装核心插件:
flutter pub add firebase_core
在
lib/main.dart
文件中,导入您之前生成的 Firebase 核心插件和配置文件:import 'package:firebase_core/firebase_core.dart'; import 'firebase_options.dart';
同样在
lib/main.dart
文件中,使用配置文件导出的DefaultFirebaseOptions
对象初始化 Firebase:await Firebase.initializeApp( options: DefaultFirebaseOptions.currentPlatform, );
重新构建 Flutter 应用:
flutter run
在您的 Flutter 项目目录中,运行以下命令:
flutter pub add firebase_vertexai
完成后,重新构建您的 Flutter 项目:
flutter run
第 3 步:初始化 Vertex AI 服务和生成模型
您需要先初始化 Vertex AI,然后才能进行任何 API 调用。 服务和生成模型。
import 'package:firebase_vertexai/firebase_vertexai.dart';
import 'package:firebase_core/firebase_core.dart';
// Initialize FirebaseApp
await Firebase.initializeApp();
// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
// Gemini 1.5 models are versatile and can be used with all API capabilities
final model =
FirebaseVertexAI.instance.generativeModel(model: 'gemini-1.5-flash');
看完入门指南后,您可以了解一下 Gemini 模型,以及(可选) 位置。
第 4 步:调用 Vertex AI Gemini API
现在,您已将应用关联到 Firebase、添加了 SDK 并初始化了 Vertex AI 服务和生成模型, 您已准备好调用 Vertex AI Gemini API。
您可以使用 generateContent()
根据纯文本提示生成文本
请求:
import 'package:firebase_vertexai/firebase_vertexai.dart';
import 'package:firebase_core/firebase_core.dart';
await Firebase.initializeApp();
// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
// Gemini 1.5 models are versatile and can be used with all API capabilities
final model =
FirebaseVertexAI.instance.generativeModel(model: 'gemini-1.5-flash');
// Provide a prompt that contains text
final prompt = [Content.text('Write a story about a magic backpack.')];
// To generate text output, call generateContent with the text input
final response = await model.generateContent(prompt);
print(response.text);
您还可以做些什么?
详细了解 Gemini 模型
详细了解 适用于各种应用场景的模型 及其 配额和定价。
试用Gemini API的其他功能
- 详细了解如何从 纯文字提示,包括如何 流式传输响应。
- 生成文本: 多模态提示 (包括文本、图片、PDF 文件、视频和音频)。
- 建立多轮对话(聊天)。
- 使用函数调用进行连接 生成模型与外部系统和信息共享。
了解如何控制内容生成
。 您还可以使用以下方法对提示和模型配置进行实验: Vertex AI Studio。提供反馈 分享您对Vertex AI in Firebase的体验