Firebase AI Logic 基础

概述

Firebase AI Logic是Firebase旗下的产品，开发者可通过客户端SDK将生成式AI添加到移动和Web应用中。你无需管理专用后端，即可直接从应用中调用Gemini模型。Firebase AI Logic的前身是“Vertex AI for Firebase”，是谷歌面向移动和Web开发者的AI集成平台的演进版本。

它支持两种Gemini API提供商：

Gemini Developer API：提供免费层级，非常适合原型开发；生产环境采用按需付费模式
Vertex AI Gemini API：适合规模化场景，具备企业级生产就绪能力，需要Blaze付费方案

默认使用Gemini Developer API，仅当应用有特定需求时才使用Vertex AI Gemini API。

设置与初始化

前提条件

开始之前，请确保已安装**Node.js 16+**和npm。如果尚未安装，请先进行安装。
在开始前确定用户感兴趣的开发平台：Android、iOS、Flutter或Web。
如果用户的平台不受支持，请引导他们查看Firebase文档了解如何为其应用设置AI Logic（可将此链接分享给用户：https://firebase.google.com/docs/ai-logic/get-started）

安装

该库是标准Firebase Web SDK的一部分。

npm install -g firebase@latest

如果你处于firebase目录（包含firebase.json文件），可通过以下命令查看当前选中的项目（标记为“current”）：

npx -y firebase-tools@latest projects:list

确保当前项目关联至少一个应用：

npx -y firebase-tools@latest apps:list

使用init命令初始化AI Logic SDK：

npx -y firebase-tools@latest init # 选择AI Logic

这将自动在Firebase控制台中启用Gemini Developer API。

更多信息请查看Firebase AI Logic 快速入门

核心功能

纯文本生成

多模态（文本 + 图片/音频/视频/PDF输入）

Firebase AI Logic允许Gemini模型直接从你的应用中分析图像文件。这支持生成图片说明、回答与图片相关的问题、检测物体以及分类图片等功能。除图片外，Gemini还可分析音频、视频和PDF等其他媒体类型，只需将它们作为带有MIME类型的内联数据传递即可。对于大于20MB的文件（作为内联数据传递可能导致HTTP 413错误），请将其存储在Cloud Storage for Firebase中，并将其URL传递给Gemini Developer API。

对话会话（多轮交互）

使用

startChat

自动维护对话历史。

流式响应

为提升用户体验，可在结果生成过程中显示部分内容（类似打字效果），使用

generateContentStream

替代

generateContent

以更快地展示结果。

使用Nano Banana生成图片

大多数场景下优先使用Gemini，仅当图像质量和特定风格是关键需求的专业任务中选择Imagen。（示例：gemini-2.5-flash-image）
需要升级到Blaze按需付费账单方案。

内置googleSearch工具的搜索Grounding

支持的平台与框架

支持的平台与框架包括：Android平台的Kotlin和Java、iOS平台的Swift、Web应用的JavaScript、Flutter平台的Dart以及Unity平台的C#。

高级功能

结构化输出（JSON）

强制响应遵循特定的JSON schema。

设备端AI（混合模式）

Web应用的混合设备端推理，Firebase JavaScript SDK会自动检查Gemini Nano的可用性（安装后），并在设备端或云端提示执行之间切换。这需要特定步骤在Chrome浏览器中启用模型使用，更多信息请查看混合设备端推理文档。

安全性与生产环境

App Check

[!WARNING] 关键安全要求： 为安全使用AI Logic，你必须在应用中设置App Check。这可防止未授权客户端占用你的API配额并访问后端资源。

设置说明请查看使用reCAPTCHA Enterprise的App Check。

Remote Config

建议不要硬编码模型名称（例如

gemini-flash-lite-latest

）。使用Firebase Remote Config动态更新模型版本，无需部署新的客户端代码。详情请查看远程更改模型名称

初始化代码参考

语言、框架、平台	Gemini API提供商	上下文URL
Web模块化API	Gemini Developer API（开发者API）	firebase://docs/ai-logic/get-started

除非文档或用户要求使用其他模型，否则请始终使用最新版本的Gemini（gemini-flash-latest）。请勿使用gemini-1.5-flash

参考资料

Web SDK代码示例与使用模式

firebase-ai-logic-basics

NPX安装

标签

SKILL.md 内容（中文）