Starting November 2, 2026, Firebase App Check enforcement will be required to use Firebase AI Logic. Learn more.
Model updates:
The latest Gemini models, like Gemini 3.7 Flash, are available to use with
Firebase AI Logic! Learn more.
Gemini 2.5 models will shut down in October 2026. To avoid service disruptions,
update to a newer model (like
gemini-3.7-flash or gemini-3.1-flash-image).
Any stable Gemini Live API 2.5 models are not impacted.
Learn more.
本页面介绍了 Gemini API
和 Firebase AI Logic SDK 的常见错误代码的排查方法。
400 错误：API key not valid. Please pass a valid API key.
如果您收到 400 错误，内容为 API key not valid. Please pass a valid API key.，通常意味着 Firebase 配置文件/对象中的 API 密钥不存在，或者未设置为与您的应用和/或 Firebase 项目搭配使用。
检查 Firebase 配置文件/对象中列出的 API 密钥是否与应用的 API 密钥匹配。您可以在
API 和服务 > 凭据
面板中查看所有 API 密钥。Google Cloud
如果您发现它们不匹配，请
获取新的 Firebase 配置文件/对象，
然后替换应用中的文件/对象。新的配置文件/对象
应包含适用于您的应用和 Firebase 项目的有效 API 密钥。
400 错误: Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.
如果您尝试使用 Cloud Storage for Firebase
网址发送多模态请求，可能会遇到以下 400 错误： Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.
此错误是由项目在项目中启用 Agent Platform API 时，未正确自动配置所需的服务代理
而导致的。这是某些项目的已知问题，我们正在努力进行全局修复。
以下是修复项目并正确配置这些服务
代理的解决方法，以便您开始在多模态请求中添加 Cloud Storage for Firebase 网址。您必须是项目上的
所有者，并且只需为项目
完成一次此任务集。
访问 gcloud CLI 并进行身份验证。
最简单的方法是通过 Cloud Shell 进行访问。如需了解详情，请参阅
Google Cloud文档。
403 错误: PERMISSION_DENIED: Firebase AI Logic has been deactivated in this project. To resume using Firebase AI Logic, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check
如果您收到 403 - PERMISSION_DENIED 错误，内容为
Firebase AI Logic has been deactivated in this project. To resume using
Firebase AI Logic, you must enforce Firebase App Check. Learn more:
https://firebase.google.com/docs/ai-logic/app-check，
则表示您的 Firebase 项目已被标识为非活跃项目，并且您
未对 Firebase AI Logic 强制执行 App Check。
“非活跃项目”是指启用了 Firebase AI Logic，但最近没有使用 Firebase AI Logic 的项目。
由于您未对 App Check 强制执行 Firebase AI Logic，因此您的
项目很容易被滥用 Gemini API。为了帮助保护您的
项目，Firebase 停用了 Firebase AI Logic 的使用，直到您对
App Check强制执行 Firebase AI Logic。
403 错误：PERMISSION_DENIED: The caller does not have permission.
如果您收到 403 错误，内容为 PERMISSION_DENIED: The caller does not have permission.，通常意味着 Firebase 配置文件/对象中的 API 密钥属于其他 Firebase 项目。
检查 Firebase 配置文件/对象中列出的 API 密钥是否与应用的 API 密钥匹配。您可以在
API 和服务 > 凭据
面板中查看所有 API 密钥。Google Cloud
如果您发现它们不匹配，请
获取新的 Firebase 配置文件/对象，
然后替换应用中的文件/对象。新的配置文件/对象
应包含适用于您的应用和 Firebase 项目的有效 API 密钥。
403 错误: Requests to this API firebasevertexai.googleapis.com ... are blocked.
如果您收到 403 错误，内容为 Requests to this API firebasevertexai.googleapis.com ... are blocked.，通常意味着应用中 Firebase 配置的 API 密钥具有限制，阻止其调用所需的 API。
如需解决此问题，您需要在 API 密钥的限制中更新
Google Cloud 控制台，以包含所需的 API。对于 Firebase AI Logic，
您必须确保 Firebase AI Logic API
(firebasevertexai.googleapis.com) 包含在可以使用 API 密钥调用的所选
API 列表中。
在“所选 API”下拉菜单中，搜索并选择
Firebase AI Logic API，将其添加到可以使用 API 密钥调用的所选
API 列表中。
点击保存 。
更改可能需要最多五分钟才能生效。
404 错误: Firebase AI Logic genai config not found
如果您收到 404 错误，内容为 Firebase AI Logic genai config not found，
通常意味着 Firebase AI Logic 的设置配置错误或
缺失。
以下是此错误最可能的原因：
您尚未为 Gemini API 提供程序设置 Firebase 项目。
操作方法：
在 Firebase 控制台中，依次前往 AI 服务 >
AI Logic。点击开始使用 ，然后选择
您选择的 Gemini API 提供程序。启用该 API，Firebase 将为该提供程序设置您的项目。完成工作流后，请再次尝试您的请求。
如果您最近在 Firebase AI Logic 设置工作流中完成了 Firebase 控制台，则 Firebase AI Logic 的配置可能尚未在所有适用区域的所有必需后端服务中提供。
操作方法：
等待几分钟，然后再次尝试您的请求。
404 错误：模型“was not found or your project does not have access to it”？
例如：“Publisher Model projects/PROJECT-ID/locations/us-central1/publishers/google/models/gemini-3.1-pro-preview was not found or your project does not have access to it. Please ensure you are using a valid model version.”
