常见问题解答和问题排查

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

为什么名称从“Vertex AI in Firebase”更改为“Firebase AI Logic”？

早在 2024 年，我们就推出了一组 Firebase 客户端 SDK，这些 SDK 可以使用 Vertex AI Gemini API 和 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）。

使用 Gemini Developer API 和 Vertex AI Gemini API 有何区别？

以下是这两种“Gemini API”提供程序之间的一些区别（无论您以何种方式访问它们，通常都是如此）：

• 价格

  • Gemini Developer API 提供“免费层级”以及随用随付的定价方案。

  • 将 Vertex AI Gemini API 与 Firebase AI Logic 搭配使用时，始终需要采用随用随付 Blaze 定价方案。

  请注意，这两家 API 提供商采用的按需付费价格不同（如需了解详情，请参阅各自的文档）。

• 速率限制（配额）

  • Gemini Developer API 具有明确的速率限制。

  • Vertex AI Gemini API 使用“动态共享配额 (DSQ)”，该配额由该区域内使用该模型的所有用户共享。您还可以根据需要设置预配吞吐量 (PT)。

• 指定访问模型的位置

  • 只有 Vertex AI Gemini API 允许您选择访问模型的位置。

下表列出了两个“Gemini API”提供程序的常见功能的可用性。此表格专门适用于使用 Firebase AI Logic 客户端 SDK 的情况。

¹ Gemini Developer API 不支持通过 Firebase AI Logic SDK 使用 Files API。

我可以同时使用 Gemini Developer API 和 Vertex AI Gemini API 吗？

可以，您可以在 Firebase 项目中同时启用两个“Gemini API”提供程序，并且可以在应用本身中使用这两个 API。

如需在代码中切换 API 提供程序，只需确保您已在代码中正确设置后端服务。

哪些 API 是必需的？如何启用这些功能？

如需将 Firebase AI Logic SDK 与 Gemini Developer API 搭配使用，您的项目必须启用以下两个 API：

• Gemini Developer API（generativelanguage.googleapis.com 人）
• Firebase AI Logic API (firebasevertexai.googleapis.com)

您应使用 Firebase 控制台启用以下两个 API：

1. 在 Firebase 控制台中，前往 Firebase AI Logic 页面。

2. 点击开始使用。

3. 选择即可开始使用 Gemini Developer API。

   这会启动一个引导式工作流程，为您启用这两个 API。控制台还会生成一个 Gemini API 密钥，并将 Firebase AI Logic API 添加到 Firebase API 密钥的许可名单中。

哪些模型可以与 Firebase AI Logic SDK 搭配使用？

• 您可以将任何 Gemini 和 Imagen 3 基础模型与 Firebase AI Logic SDK（包括预览版和实验版）搭配使用。如需查看这些模型的列表，请参阅了解支持的模型。

• 您不能将非基础 Gemini 模型（例如 PaLM 模型、经过调优的模型或基于 Gemma 的模型）与 Firebase AI Logic SDK 搭配使用。

  Firebase AI Logic 也不支持旧版 Imagen 模型或 imagen-3.0-capability-001。

• Gemini Developer API（无论以何种方式访问）不支持 imagen-3.0-fast-generate-001 或旧版 imagen-3.0-generate-001。

我们会经常向 SDK 添加新功能，因此请定期查看此常见问题解答，了解最新动态（以及发布说明、博客和社交媒体帖子）。

模型弃用后该怎么办？

发布稳定模型版本时，我们会努力确保该版本至少可用一年。我们会在 Firebase 和 Google Cloud 文档的多个位置列出此“弃用日期”（例如，在“模型”页面中）。

当模型被弃用后，对该模型的所有请求都会失败并显示 404 错误。因此，我们强烈建议您设置和使用 Firebase Remote Config，以便动态更改应用中的模型和版本，而无需发布应用的新版本。

更新应用以使用新模型版本时，我们建议您测试应用，确保回答仍能按预期给出。请注意，使用 Firebase AI Logic 时，通常不需要修改实际调用模型的任何代码。

以下是各种型号的弃用日期：

• 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 日）

如何设置单个用户的速率限制？

默认情况下，Firebase AI Logic 将每个用户的请求数限制设置为每分钟 100 个请求 (RPM)。

如果您想调整每位用户的速率限制，则需要调整 Firebase AI Logic API 的配额设置。

详细了解 Firebase AI Logic API 配额。您还可以在该页面上了解如何查看和修改配额。

使用 Firebase AI Logic SDK 需要哪些权限？

Firebase AI Logic 是否会使用我的数据来训练模型？

请参阅数据治理和负责任 AI。

我的多模态请求中是否必须包含 MIME 类型？（例如图片、PDF、视频和音频输入）

是的，在每个多模式请求中，您都必须始终提供以下内容：

• 文件的 mimeType。请参阅下文中的例外情况。

• 文件。您可以以内嵌数据的形式提供文件，也可以使用文件网址提供文件。

如需了解支持的输入文件类型、如何指定 MIME 类型以及提供文件的两种方式，请参阅支持的输入文件和要求。

在请求中添加 MIME 类型的例外情况

提供 MIME 类型的一个例外情况是，对于来自原生 Android 和 Apple 平台应用的请求，可以使用内嵌图片输入。

适用于 Android 和 Apple 平台的 Firebase AI Logic SDK 提供了一种简化且适用于各平台的方式来处理请求中的图片：所有图片（无论格式如何）都会在客户端转换为 JPEG，质量为 80%，然后再发送到服务器。这意味着，当您使用 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 搜索进行接地、代码执行、微调模型、嵌入生成和语义检索？

各种模型或 Vertex AI Gemini API 支持上下文缓存、将搜索用作工具、依托 Google 搜索进行接地、代码执行、微调模型、生成嵌入和语义检索，但使用 Firebase AI Logic 时无法使用这些功能。

如果您想将这些功能添加为功能请求，或对现有功能请求进行投票，请访问 Firebase UserVoice。

什么是 Gemini API 密钥？

Gemini Developer API 使用“Gemini API 密钥”来授权调用方。因此，如果您通过 Firebase AI Logic SDK 使用 Gemini Developer API，则需要在 Firebase 项目中拥有有效的 Gemini API 密钥才能调用该 API。

“Gemini API 密钥”只是指 API 许可名单中包含 Gemini Developer API 的 API 密钥。

当您在 Firebase 控制台中完成 Firebase AI Logic 设置工作流时，我们会创建一个仅限 Gemini Developer API 使用的 Gemini API 密钥，并设置 Firebase AI Logic 代理服务以使用此 API 密钥。在 Google Cloud 控制台的凭据页面中，此 Firebase 生成的 Gemini API 密钥名为 Gemini Developer API 密钥（由 Firebase 自动创建）。

详细了解 API 密钥的 API 限制。

使用 Firebase AI Logic SDK 时，请不要将 Gemini API 密钥添加到应用的代码库中。详细了解如何保障 Gemini API 密钥的安全。

我是否应将 Gemini API 密钥添加到移动应用或 Web 应用的代码库中？

使用 Firebase AI Logic SDK 时，请不要将 Gemini API 密钥添加到应用的代码库中。

事实上，在使用 Firebase AI Logic SDK 进行开发时，您不会直接与 Gemini API 密钥进行交互。相反，我们的 Firebase AI Logic 代理服务会在向 Gemini Developer API 发出的每个请求中在内部添加 Gemini API 密钥，完全在后端进行。

如何更改用于调用 Gemini Developer API 的 Gemini API 密钥？

使用 Firebase AI Logic SDK 时，您不太可能需要更改 Gemini API 密钥。不过，在以下两种情况下，您可能需要执行以下操作：

• 如果您不小心泄露了密钥，并想将其替换为新的安全密钥。

• 如果您不小心删除了密钥。请注意，您可以在删除密钥后的 30 天内取消删除该密钥。

您可以按以下步骤更改 Firebase AI Logic SDK 使用的 Gemini API 密钥：

1. 如果 Firebase 生成的 Gemini API 密钥仍然存在，请将其删除。

   您可以在 Google Cloud 控制台的 API 和服务 > 凭据面板中删除此 API 密钥。该密钥的名称为：
   Gemini Developer API 密钥（由 Firebase 自动创建）。

2. 在 Google Cloud 控制台的同一页面中，创建新的 API 密钥。我们建议您使用以下名称：
   适用于 Firebase 的 Gemini Developer API 密钥。

3. 为这个新的 API 密钥添加 API 限制，并仅选择 Generative Language API。
   Gemini Developer API 在 Google Cloud 控制台中有时称为“生成式语言 API”。

   请不要添加任何应用限制；否则，Firebase AI Logic 代理服务将无法正常运行。

4. 运行以下命令，将此新密钥设置为 Firebase AI Logic 代理服务应使用的 Gemini API 密钥。

   PROJECT_ID="PROJECT_ID"
   GENERATIVE_LANGUAGE_API_KEY="DEVELOPER_CREATED_GEMINI_API_KEY"
   curl \
     -X PATCH \
     -H "x-goog-user-project: ${PROJECT_ID}" \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     "https://firebasevertexai.googleapis.com/v1beta/projects/${PROJECT_ID}/locations/global/config" \
     -d "{\"generativeLanguageConfig\": {\"apiKey\": \"${GENERATIVE_LANGUAGE_API_KEY}\"}}"
   

   了解 gcloud CLI。

请务必不将此新的 Gemini API 密钥添加到应用的代码库。详细了解如何保障 Gemini API 密钥的安全。

我可以将“Firebase API 密钥”用作 Gemini API 密钥吗？

不可以。您不得将“Firebase API 密钥”用作 Gemini API 密钥。我们强烈建议您不要将 Gemini Developer API 添加到 Firebase API 密钥的许可名单中。

您的 Firebase API 密钥是指 Firebase 配置文件或对象中列出的 API 密钥，您将其添加到应用的代码库中，以便将应用连接到 Firebase。如果您仅将 Firebase API 密钥用于 Firebase 相关 API（例如 Firebase AI Logic），则可以将其包含在代码中。 了解有关 Firebase API 密钥的重要信息。