Gemini 2.5 models will shut down in October 2026. To avoid service disruptions,
update to a newer model (like
gemini-3.6-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 错误: 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 列表中。
点击保存 。
更改可能需要最多 5 分钟才能生效。
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 密钥。
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 控制台中完成了 Firebase AI Logic 设置工作流，则 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.”
