本页面提供了有关 Firebase AI Logic 的常见问题解答 (FAQ) 和问题排查信息，以及如何将 与 Gemini API 搭配使用。
如有需要，您还可以参考以下资源：
排查错误代码。
了解结算设置、价格和付款。
了解速率限制和配额。
状态信息中心
Agent Platform Gemini API (formerly Vertex AI)（
Vertex Gemini API和Vertex Imagen API）
常规常见问题解答
使用 Gemini Developer API 和 Agent Platform Gemini API (formerly Vertex AI) 有何区别？
下表列出了两个“Gemini API”提供程序的一般重要区别，无论您如何访问它们：
| Gemini Developer API | Agent Platform Gemini API (formerly Vertex AI) | |
|---|---|---|
| 价格 | 适用于免费的 Spark 定价方案和随用随付的 Blaze 定价方案1 | 始终需要采用随用随付 Blaze 定价方案1（与 Firebase AI Logic 搭配使用时） |
| 速率限制（配额） | 明确的速率限制 | 使用动态共享配额 (DSQ)，该区域中使用相应模型的所有用户共享该配额。预配吞吐量 (PT) 可用。 |
| 指定访问模型的位置 | API 不支持 | API 支持的 |
| 支持 Cloud Storage 网址 | API 不支持 2 |
公开文件和受 Firebase Security Rules 保护的文件 |
| 支持 YouTube 网址和浏览器网址 | 仅限 YouTube 网址 | YouTube 网址和浏览器网址 |
1 这两个 API 提供商的随用随付价格不同（如需了解详情，请参阅其各自的文档）。
2 Gemini Developer API 的文件 API 不受 Firebase AI Logic SDK 支持。
下表列出了两个“Gemini API”提供商提供的常见功能。此表专门适用于使用 Firebase AI Logic 客户端 SDK 的情况。
| 功能 | Gemini Developer API | Agent Platform Gemini API (formerly Vertex AI) |
|---|---|---|
| Gemini 型号支持 | 支持 | 支持 |
| 支持 Gemini Live API | 支持 | 支持 |
| 与 Firebase App Check 集成 | 支持 | 支持 |
| 与 Firebase Remote Config 兼容 | 支持 | 支持 |
| 支持在 Firebase 控制台中进行 AI 监控 | 支持 | 支持 |
我可以同时使用 Gemini Developer API 和 Agent Platform Gemini API (formerly Vertex AI) 吗？
可以。您可以在 Firebase 项目中同时启用“Gemini API”提供程序，并且可以在应用本身中使用这两个 API。
如需在代码中切换 API 提供商，只需确保您已在代码中相应地设置后端服务。
将“Vertex AI”更名为“Agent Platform”需要进行哪些更改？
在 2026 年年中，Google Cloud将“Vertex AI”更名为“Gemini Enterprise Agent Platform”（或“Agent Platform”）。在 Firebase 生态系统中，我们将此服务称为“Agent Platform Gemini API”。
对于 Google Cloud，此次品牌重塑包括以下内容。请注意，还有其他更改，但它们不适用于 Firebase AI Logic。
将产品名称从“Vertex AI”更改为“Gemini Enterprise Agent Platform”（或“Agent Platform”），其中包括Google Cloud 控制台和文档的新网址。
将 API 的显示名称从“Vertex AI API”更改为“Agent Platform API”。请注意，服务名称保持不变：
aiplatform.googleapis.com。将“Vertex AI Studio”更名为“Agent Studio”。
底层 API 或支持的模型的功能没有变化。
对于 Firebase AI Logic SDK，我们通过以下方式来适应此次品牌重塑：更新“Gemini API”后端服务的初始化语法，以及更新使用此新语法时访问模型的默认位置。
“Gemini API”后端服务的新初始化语法：
Swift
将
vertexai更改为agentPlatform。
从 Firebase SDK 12.17.0（Apple 平台）开始提供。之前
// ... // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI). // For the legacy `vertexai` syntax, the default location is `us-central`, so // specifying a location is usually required since most models are *not* supported in `us-central`. let ai = FirebaseAI.firebaseAI(backend: .vertexai(location: "LOCATION")) // ...升级后
// ... // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI). // For the `agentPlatform` syntax, the default location is `global`, so // specifying a location is usually optional since most models are supported in `global`. let ai = FirebaseAI.firebaseAI(backend: .agentPlatform(location: "LOCATION")) // ...Kotlin
将
vertexAI更改为agentPlatform。
从 Firebase AI Logic SDK for Android v17.15.0+（Firebase Android BoM v34.17.0+）开始提供。之前
// ... // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI). // For the legacy `vertexAI` syntax, the default location is `us-central`, so // specifying a location is usually required since most models are *not* supported in `us-central`. val ai = Firebase.ai(backend = GenerativeBackend.vertexAI(location = "LOCATION")) // ...升级后
// ... // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI). // For the `agentPlatform` syntax, the default location is `global`, so // specifying a location is usually optional since most models are supported in `global`. val ai = Firebase.ai(backend = GenerativeBackend.agentPlatform(location = "LOCATION")) // ...Java
将
vertexAI更改为agentPlatform。
从 Firebase AI Logic SDK for Android v17.15.0+（Firebase Android BoM v34.17.0+）开始提供。之前
// ... // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI). // For the legacy `vertexAI` syntax, the default location is `us-central`, so // specifying a location is usually required since most models are *not* supported in `us-central`. GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.vertexAI("LOCATION")); // ...升级后
// ... // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI). // For the `agentPlatform` syntax, the default location is `global`, so // specifying a location is usually optional since most models are supported in `global`. GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.agentPlatform("LOCATION")); // ...Web
将
VertexAIBackend更改为AgentPlatformBackend。
从 Firebase JS SDK v12.17.0 开始提供。之前
import { getAI, getGenerativeModel, VertexAIBackend } from "firebase/ai"; // ... // Initialize FirebaseApp // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI). // For the legacy `VertexAIBackend` syntax, the default location is `us-central`, so // specifying a location is usually required since most models are *not* supported in `us-central`. const ai = getAI(firebaseApp, { backend: new VertexAIBackend('LOCATION') }); // ...升级后
import { getAI, getGenerativeModel, AgentPlatformBackend } from "firebase/ai"; // ... // Initialize FirebaseApp // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI). // For the `AgentPlatformBackend` syntax, the default location is `global`, so // specifying a location is usually optional since most models are supported in `global`. const ai = getAI(firebaseApp, { backend: new AgentPlatformBackend('LOCATION') }); // ...Dart
将
vertexAI更改为agentPlatform。
从 Firebase AI Logic 插件 for Flutter v3.15.0 及更高版本（Firebase Flutter BoM v4.18.0 及更高版本）开始提供。之前
// ... // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI). // For the legacy `vertexAI` syntax, the default location is `us-central`, so // specifying a location is usually required since most models are *not* supported in `us-central`. final ai = await FirebaseAI.vertexAI(location: 'LOCATION'); // ...升级后
// ... // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI). // For the `agentPlatform` syntax, the default location is `global`, so // specifying a location is usually optional since most models are supported in `global`. final ai = await FirebaseAI.agentPlatform(location: 'LOCATION'); // ...Unity
将
VertexAI更改为AgentPlatform。
从 Firebase SDK for Unity v13.15.0 开始提供。之前
// ... // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI). // For the legacy `VertexAI` syntax, the default location is `us-central`, so // specifying a location is usually required since most models are *not* supported in `us-central`. var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.VertexAI(location: "LOCATION")); // ...升级后
// ... // Initialize the Agent Platform Gemini API backend service (formerly Vertex AI). // For the `AgentPlatform` syntax, the default location is `global`, so // specifying a location is usually optional since most models are supported in `global`. var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.AgentPlatform(location: "LOCATION")); // ...使用新的初始化语法时，访问模型的新默认位置：
使用新的“Agent Platform”初始化语法时，位置默认设置为
global。做出此更改是因为
global支持几乎所有 Gemini 型号，而 Google Cloud 不再支持大多数 Gemini 型号的新版本所用的us-central1位置。
需要哪些 API？以及如何启用这些功能？
|
选择您的 Gemini API 提供方以查看特定于提供方的内容 |
如需将 Firebase AI Logic SDK 与 Agent Platform Gemini API (formerly Vertex AI) 搭配使用，您的项目必须启用以下两个 API：
- Agent Platform API (
aiplatform.googleapis.com) - Firebase AI Logic API (
firebasevertexai.googleapis.com)
您可以使用以下任一选项来启用这些 API：
方法 1 （推荐）：在 Firebase 控制台中点击几下即可启用 API：
在 Firebase 控制台中，前往 AI 服务 > Firebase AI Logic 页面。
点击开始使用。
选择即可开始使用 Agent Platform Gemini API (formerly Vertex AI)。
系统随即会启动引导式工作流，以便您启用这两个 API。 Firebase 还会预配一个 Google 管理的服务账号 (P4SA)，用于授权使用 Gemini API，并将 Firebase AI Logic API 添加到 Firebase API 密钥的许可名单中。
方法 2（手动；不推荐）：在 Google Cloud 控制台中启用 API：
点击此常见问题解答条目顶部的每个 API 链接，然后点击每个 API 页面中的启用。
将 Firebase AI Logic API 添加到 Firebase API 密钥的许可名单中。
如何在 Firebase 项目中停用 API？
对于 Firebase AI Logic，我们会尽力让您轻松设置 Firebase 项目，以便使用所选的 Gemini API 提供方。这包括在特定流程（例如 Firebase 控制台中的引导式工作流）期间，在 Firebase 项目中启用必需的 API。
不过，如果您决定不使用 Firebase AI Logic 或任何 Gemini API 提供商，则可以在 Firebase 项目中停用关联的 API。
停用与使用 Gemini Developer API 关联的 API
如需将 Firebase AI Logic SDK 与 Gemini Developer API 搭配使用，您的项目必须启用以下两个 API：
-
Gemini Developer API (
generativelanguage.googleapis.com) - Firebase AI Logic API (
firebasevertexai.googleapis.com)
如果您想完全停止使用 Firebase AI Logic：
点击上方的每个 API 链接，前往 Google Cloud 控制台中的相应 API 页面，然后点击管理。
查看指标标签页，验证 API 是否未被使用。
如果您仍想停用该 API，请点击页面顶部的停用 API。
从可以使用您的 Firebase API 密钥调用的所选 API 列表中移除 Firebase AI Logic API。请查看有关 Firebase API 密钥许可名单的这篇常见问题解答，了解如何修改此列表。
如果您想继续使用 Firebase AI Logic，但改用 Agent Platform Gemini API (formerly Vertex AI)：
前往 Google Cloud 控制台中的 Gemini Developer API 页面，然后点击管理。
查看指标标签页，验证 API 是否未被使用。
如果您仍想停用该 API，请点击页面顶部的停用 API。
确保您的项目已 启用 Agent Platform Gemini API (formerly Vertex AI) 所需的 API。
停用与使用 Agent Platform Gemini API (formerly Vertex AI) 关联的 API
如需将 Firebase AI Logic SDK 与 Agent Platform Gemini API (formerly Vertex AI) 搭配使用，您的项目必须启用以下两个 API：
- Agent Platform API (
aiplatform.googleapis.com) - Firebase AI Logic API (
firebasevertexai.googleapis.com)
如果您想完全停止使用 Firebase AI Logic：
点击上方的每个 API 链接，前往 Google Cloud 控制台中的相应 API 页面，然后点击管理。
查看指标标签页，验证 API 是否未被使用。
如果您仍想停用该 API，请点击页面顶部的停用 API。
从可以使用您的 Firebase API 密钥调用的所选 API 列表中移除 Firebase AI Logic API。请查看有关 Firebase API 密钥许可名单的这篇常见问题解答，了解如何修改此列表。
如果您想继续使用 Firebase AI Logic，但改用 Gemini Developer API：
前往 Google Cloud 控制台中的 Agent Platform API 页面，然后点击管理。
查看指标标签页，验证 API 是否未被使用。
如果您仍想停用该 API，请点击页面顶部的停用 API。
确保您的项目已 启用 Gemini Developer API 所需的 API。
使用 Firebase AI Logic 可能需要哪些权限？
| 操作 | 必需的 IAM 权限 | 默认包含所需权限的 IAM 角色 |
|---|---|---|
| 将结算升级为随用随付 (Blaze) 定价方案 | firebase.billingPlans.updateresourcemanager.projects.createBillingAssignmentresourcemanager.projects.deleteBillingAssignment
|
Owner |
| 在项目中启用 API | serviceusage.services.enable |
Editor Owner |
| 创建 Firebase 应用 | firebase.clients.create |
Firebase 管理员 编辑者 所有者 |
使用 Firebase AI Logic 时支持哪些模型？
请参阅支持的型号列表。 我们会经常向 SDK 添加新功能，因此请经常查看此常见问题解答以了解最新动态（以及版本说明、博客和社交媒体帖子）。
Firebase AI Logic 支持以下模型：
Gemini Developer API
- 大多数 Gemini 和 Imagen 基础模型
请注意，Gemini Developer API（无论以何种方式访问）仅支持特定的稳定版 Imagen 模型。
Agent Platform Gemini API (formerly Vertex AI)
- 大多数 Gemini 和 Imagen 基础模型
Firebase AI Logic 不支持以下型号（无论您选择的 Gemini API 提供商是谁）：
微调模型
嵌入模型、Veo 模型、Lyria 模型、机器人模型、计算机使用模型、Gemini Omni 模型或 Gemini Flash Cyber 模型
较旧的 Imagen 型号或
imagen-3.0-capability-001
模型关闭（停用）后该怎么办？
Google 发布稳定版模型后，会尽力确保该模型至少在 12 个月内可用，然后才会关闭（停用）该模型。不过请注意，对于 Agent Platform Gemini API (formerly Vertex AI)，某些稳定版模型仅具有短期可用性，这意味着它们可能会在替代模型发布后 45 天内关机（弃用）。
在哪里可以找到模型的关停日期？
您可以通过以下几种方式查找模型的关停日期：
发布时：我们在 Gemini API 提供方文档以及 Firebase 文档中的多个地点列出了每个模型的预期关停日期（请参阅支持的模型页面）。
在关停日期临近时：Google 会向相应的项目成员发送电子邮件，并在版本说明和其他渠道中发布有关即将关停的提醒（例如，Gemini 1.5 和 1.0 稳定版模型的关停日期提醒）。
如果您使用的模型即将关闭，该怎么办？
在关停日期之前更新应用使用的模型名称；否则，对该模型的所有请求都会失败，并显示 404 错误。
您可以在初始化期间创建
GenerativeModel、LiveModel或ImagenModel实例时设置模型名称。请务必查看下文有关使用 Firebase Remote Config 或服务器提示模板的重要建议。使用 Firebase AI Logic 时，您通常不需要修改任何实际调用模型的代码。
请注意，对于 Gemini 3.x 模型，采样参数（温度、top-K、top-P）已弃用。
测试应用，确保响应仍符合预期。
Gemini 2.5 稳定模型 - 关停日期和替代模型
Gemini 2.5 Pro、Gemini 2.5 Flash 和 Gemini 2.5 Flash‑Lite
gemini-2.5-pro
gemini-2.5-flash
gemini-2.5-flash-lite
gemini-2.5-flash-image（又称“Nano Banana”）对于通用模型，关停日期取决于您选择的 Gemini API 提供方：
- Gemini Developer API（Google AI）：2026 年 10 月 16 日
- Agent Platform Gemini API (formerly Vertex AI)：2026 年 10 月 20 日
对于图片生成模型 (Nano Banana)，无论您选择哪个 Gemini API 提供商，关闭日期都相同：2026 年 10 月 2 日
请注意，其他“Nano Banana”模型和任何稳定的 Gemini Live API 2.5 模型不受影响。
替换：迁移到使用新的 Gemini 3.x 模型（例如 gemini-3.6-flash 或 gemini-3.1-flash-image）。
Imagen 稳定模型 - 关停日期和替代模型
- 所有 Imagen 模型最早将于 2026 年 8 月 17 日关停（请注意，此关停日期已从之前的 2026 年 6 月 30 日延期）。
替代方案： 将应用迁移为使用 Gemini 图像模型（“Nano Banana”模型）。
Gemini 2.0 稳定模型 - 关停日期和替代模型
Gemini 2.0 Flash 和 Gemini 2.0 Flash‑Lite：
gemini-2.0-flash-001（及其自动更新的别名gemini-2.0-flash）
gemini-2.0-flash-lite-001（及其自动更新的别名gemini-2.0-flash-lite）2026 年 2 月 6 日：之前未使用过这些模型的项目将无法再使用这些模型。
2026 年 3 月 31 日：这些模型将停止服务。
请注意，稳定的 Gemini Live API 2.0 模型不受影响。
替换：迁移到使用新的 Gemini 3.x 模型（例如 gemini-3.1-flash-lite）。
Gemini 1.5 和 1.0 稳定版模型 - 关停日期和替代模型
Gemini 1.5 Pro 模型：
gemini-1.5-pro-002（和gemini-1.5-pro）：2025 年 9 月 24 日gemini-1.5-pro-001：2025 年 5 月 24 日
Gemini 1.5 Flash 模型：
gemini-1.5-flash-002（和gemini-1.5-flash）：2025 年 9 月 24 日gemini-1.5-flash-001：2025 年 5 月 24 日
Gemini 1.0 Pro Vision 型号：2025 年 4 月 21 日（之前计划为 2025 年 4 月 9 日）
Gemini 1.0 Pro 型号：2025 年 4 月 21 日（之前计划为 2025 年 4 月 9 日）
替换：迁移到使用新的 Gemini 3.x 模型（例如 gemini-3.1-flash-lite）。
Firebase AI Logic 是否会使用我的数据来训练模型？
如何设置单个用户的速率限制？
默认情况下，Firebase AI Logic 将每个用户的请求限额设置为每分钟 100 个请求 (RPM)。
如果您想调整每用户的速率限制，则需要调整 Firebase AI Logic API 的配额设置。
详细了解 Firebase AI Logic API 配额。 在该页面上，您还可以了解如何查看和修改配额。
如何减少延迟和高 token 用量？
如果您遇到高延迟或高 token 用量问题，很可能是因为您所用模型的思考水平配置。
Gemini 3 及更高版本的模型始终使用内部“思考过程”，可显著提升其推理和多步规划能力，使其能够高效完成编码、高等数学和数据分析等复杂任务。
不过，根据任务的不同，有时并不需要较高的思考等级，您可以将模型配置为使用较低的思考等级。较低的思考水平有助于减少延迟和令牌使用量。为帮助您确定模型可能需要多强的思考能力，请查看任务难度比较。
请注意，对于大多数 Gemini 3 及更高版本的模型，默认思考水平设置为 HIGH。
在多模态请求中是否需要提供 MIME 类型？（例如，对于图片、PDF、视频和音频输入）
是的，在每个多模态请求中，您都必须始终提供以下内容：
文件的
mimeType。请参阅下文中的例外情况。文件。您可以内嵌方式提供文件，也可以使用文件的网址提供文件。
如需了解支持的输入文件类型、如何指定 MIME 类型以及提供文件的两种方式，请参阅支持的输入文件和要求。
在请求中包含 MIME 类型的例外情况
对于来自原生 Android 和 Apple 平台应用的请求，内嵌图片输入可不提供 MIME 类型。
适用于 Android 和 Apple 平台的 Firebase AI Logic SDK 提供了一种简化的平台友好型方式来处理请求中的图片 - 所有图片（无论其格式如何）都会在客户端转换为质量为 80% 的 JPEG 格式，然后再发送到服务器。这意味着，当您使用 Android 和 Apple 平台 SDK以内嵌数据的形式提供图片时，无需在请求中指定 MIME 类型。
这种简化的处理方式在 Firebase AI Logic 文档中发送 base64 编码图片的请求示例中有所体现。
以下是有关此功能的其他平台特定信息：
对于 Android 设备：
您可以利用一种简化的方式来处理包含内嵌数据的多模态提示中的平台原生图片类型 (
Bitmap)（请参阅示例）。如需更精细地控制图片格式和转换，您可以将图片作为
InlineDataPart提供，并提供具体的 MIME 类型。例如：content { inlineData(/* PNG as byte array */, "image/png") }
对于 Apple 平台：
您可以利用一种简化的方式来处理包含内嵌数据的多模态提示中的平台原生图片类型（
UIImage、NSImage、CIImage和CGImage）（请参阅示例）。如需更精细地控制图片格式和转换，您可以将图片作为
InlineDataPart提供，并提供具体的 MIME 类型。例如：InlineDataPart(data: Data(/* PNG Data */), mimeType: "image/png")
使用 Firebase AI Logic 时，是否可以使用以下功能：依托 Google 图片搜索进行接地、模型微调、嵌入生成和语义检索？
以下功能受各种模型和 API 提供方支持，但在使用 Firebase AI Logic 时不可用：
- 依托 Google 图片搜索进行接地
- 微调模型
- 生成嵌入
- 语义检索
如果您想将这些内容添加为功能请求或对现有功能请求进行投票，请访问 Firebase UserVoice。
为什么名称从“Vertex AI in Firebase”更改为“Firebase AI Logic”？
2024 年，我们推出了一组 Firebase 客户端 SDK，这些 SDK 可以使用 Agent Platform Gemini API (formerly Vertex AI) 以及 Firebase 代理网关来防止该 API 遭到滥用，并实现与其他 Firebase 产品的集成。我们将产品命名为“Vertex AI in Firebase”，这个产品名称准确地描述了当时产品的可用使用场景。
不过，自那以后，我们扩展了产品的功能。例如，截至 2025 年 5 月，我们现在支持 Gemini Developer API，包括能够通过与 Firebase App Check 的集成来保护 Gemini Developer API 免遭滥用。
因此，“Vertex AI in Firebase”这一名称已无法准确体现我们产品扩展后的范围。因此，我们决定采用新名称“Firebase AI Logic”，以便更好地反映我们不断发展的特征集，并让我们能够在未来继续扩展产品和服务！
请查看迁移指南，确保您能使用 Firebase AI Logic 的所有最新功能（还可以选择开始使用 Gemini Developer API）。
对于 Apple 平台上的 Swift 应用 - 如何应对模块名称从 FirebaseAI 更改为 FirebaseAILogic？
对于 Apple 平台应用，从 Firebase SDK v12.5.0 开始，Firebase AI Logic 现在在 FirebaseAILogic 模块下分发。我们已将此更改设为非重大更改，并使其向后兼容。
我们为何要进行此项变更？
我们以前通过 FirebaseAI 模块分发此服务。不过，我们需要将其重命名为 FirebaseAILogic，原因如下：
避免模块和类之间出现名称冲突，从而导致二进制分发出现问题。
使我们能够使用 Swift 宏进行未来的功能开发。
如果您要升级到 v12.5.0 及更高版本，该怎么做？
将模块名称更改为 FirebaseAILogic 不会造成重大变更，并且向后兼容。不过，我们最终可能会在未来的 Firebase SDK 重大破坏性变更版本中移除旧模块（时间范围目前尚未确定）。
此次模块名称变更无需进行任何更改，但我们建议您执行以下操作：
选择 Swift PM 依赖项时，请选择
FirebaseAILogic（而非FirebaseAI）。将导入语句更改为
FirebaseAILogic（而不是FirebaseAI）。
安全常见问题解答
以下部分包含与安全性相关的常见问题解答，例如关于 App Check 或 Gemini API 密钥的问题。
关于 Firebase App Check 的常见问题解答
是否需要为应用的所有公开版本强制执行 App Check？
是的，对于使用 Firebase AI Logic 的应用的所有公开版本，都必须强制执行 App Check。
务必尽早强制执行 App Check，尤其是在将应用提交到公开可用的源代码控制系统、分享应用或将应用公开之前。
如果您立即在应用的代码库中实现 App Check，那么您的所有应用版本都可以发送有效的 App Check 令牌。未发送有效令牌的请求会被视为未验证，并且在强制执行 App Check 时会被阻止。
如果您已向最终用户发布了未实现 App Check 的应用版本，请参阅有关如何为已发布的应用实现和强制执行 App Check 的常见问题解答。
如何为已发布的应用实现并强制执行 App Check？
对于未实现 App Check 的应用版本，从这些版本向 Firebase AI Logic 发出的请求没有有效的 App Check 令牌，因此被视为未验证。当针对 AI Logic 强制执行 App Check 时，这些请求将被阻止。
为避免已发布且不含 App Check 的应用出现服务中断，请在强制执行 App Check 之前执行以下操作。
尽快在您的应用中实现证明提供方。
Apple 平台：DeviceCheck 或 App Attest
Android： Play Integrity
Flutter：支持上述所有默认提供程序
Unity：支持上述所有默认提供程序
监控来自应用的请求，以帮助您确定何时可以安全地强制执行 App Check。
例如，如果几乎所有近期请求都来自经过验证的客户端，那么您应考虑强制执行 App Check。
对于强制执行 App Check 的本地开发，请配置 App Check 调试提供程序，以绕过证明，同时仍保持 App Check 的强制执行。请参阅相应平台的设置说明： iOS+ | Android | Web | Flutter | Unity。
有关 Gemini API 密钥的常见问题解答
Gemini Developer API 和 Firebase AI Logic 在 2026 年中期的安全升级有哪些？
从历史上看，Gemini Developer API 依赖于标准 Gemini API 密钥来授权使用 Gemini Developer API (generativelanguage.googleapis.com)。如果您启用了 Firebase AI Logic 并选择使用 Gemini Developer API，则 Firebase 会为您创建一个受限的 Gemini API 密钥，该密钥只能用于 Gemini Developer API。此密钥已命名为 Gemini Developer API key (auto created by Firebase)
从 2026 年年中开始，Gemini Developer API 将升级为更安全的替代方案，即“授权 (auth) 密钥”（本质上是服务账号）。Firebase AI Logic 已同步升级。Firebase AI Logic 现在使用 Google 管理的服务账号 (P4SA)（我们会自动为您预配）处理 Gemini Developer API 的授权，而不是使用标准 Gemini API 密钥：
Firebase AI Logic 服务代理 (service-PROJECT_ID@
对于现有项目和新项目，如果您通过 Firebase AI Logic 访问 Gemini Developer API，则无需采取任何行动，即可从 2026 年年中开始享受这些安全升级带来的好处。
我是否需要将 Gemini API 密钥迁移到“授权 (auth) 密钥”？
对于现有项目和新项目，如果您通过 Firebase AI Logic 访问 Gemini Developer API，则无需采取任何行动，即可享受自 2026 年年中开始的安全升级（包括迁移到“授权 (auth) 密钥”）。
Firebase AI Logic 会自动处理所有必需的安全更改，以适应 Gemini Developer API 的过渡，使其需要“授权 (auth) 密钥”。
自 2026 年年中起，Firebase AI Logic 将不再预配或使用标准 Gemini API 密钥。现在，Firebase AI Logic 使用 Google 管理的服务账号 (P4SA)（我们会自动在您的 Firebase 项目中为您预配该账号）来处理 Gemini Developer API 的授权：
Firebase AI Logic Service Agent (service-PROJECT_ID@
鉴于此变更，您可以查看并删除任何名为 Gemini Developer API key (auto created by Firebase)
-
此 Gemini API 密钥由 Firebase 创建，仅用于 Firebase AI Logic，因此可以安全地将其删除。
不过，在删除此密钥之前，您仍应检查以确保您没有错误地将该密钥与其他可访问 Gemini Developer API 的工具（例如 GenAI 服务器 SDK 或 Genkit）搭配使用。以下是查看使用情况的方法：
- 在 Google Cloud 控制台中，前往 Gemini Developer API 页面，然后点击管理。
-
在指标标签页的凭据下拉菜单中，选择名为
Gemini Developer API key (auto created by Firebase) -
如果显示的图表表明自 2026 年 7 月初（Firebase AI Logic 停止使用这些 API 密钥的时间）以来，该密钥一直未被使用，则可以安全地删除该密钥。
不过，如果图表显示了使用情况，则说明您正在使用其他工具使用该密钥，您应该重命名该密钥， 以便清楚地表明该密钥正在与该工具搭配使用（而非与 Firebase AI Logic 搭配使用）。
-
请确保您不会删除任何名称包含
(auto created by Firebase)
我是否应将 Gemini API 密钥添加到移动或 Web 应用的代码库中？
使用 Firebase AI Logic SDK 时，您无需使用 Gemini API 密钥来授权使用 Gemini Developer API，并且不应将 Gemini API 密钥添加到应用的代码库中。
我可以将“Firebase API 密钥”用作 Gemini API 密钥吗？
不可以，您不应将“Firebase API 密钥”用作 Gemini API 密钥。我们强烈建议您不要将 Gemini Developer API 添加到 Firebase API 密钥的许可名单中。
Firebase API 密钥是指您添加到应用代码库中以将应用连接到 Firebase 的 Firebase 配置文件或对象中所列的 API 密钥。如果您仅将 Firebase API 密钥用于 Firebase 相关 API（例如 Firebase AI Logic），则可以将其包含在代码中。 了解有关 Firebase API 密钥的重要信息。
在 Google Cloud 控制台的 API 和服务 > 凭据面板中，Firebase API 密钥如下所示：
由于您需要将 Firebase API 密钥添加到应用的代码库中，才能使 Firebase 相关 API 正常运行，并且由于 Gemini Developer API 可以通过 API 密钥进行授权，因此我们强烈建议您不要将 Gemini Developer API（在 Google Cloud 控制台中称为“Generative Language API”）添加到 Firebase API 密钥的 API 许可名单中。如果您这样做，则会使 Gemini Developer API 容易受到滥用。
如何确保 Gemini API 密钥的安全？
就您使用 Firebase AI Logic 的体验提供反馈