The latest Gemini models, like Gemini 3.1 Flash Image (Nano Banana 2), are available to use with Firebase AI Logic! Learn more.
Gemini 2.0 Flash and Flash-Lite models will shut down on June 1, 2026. To avoid service disruption, update to a newer model like gemini-2.5-flash-lite. 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.
出现此错误的原因是，当在项目中启用 Vertex AI 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 列表中。
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-pro-image-preview was not found or your project does not have access to it. Please ensure you are using a valid model version.”
如果您使用 Vertex AI Gemini API，则所有 预览版 和
实验性Gemini 模型（Gemini Live 模型除外）仅
在 global 位置提供。不过，由于 Firebase AI Logic
默认使用 us-central1 位置，因此在使用这些
预览版和实验性Gemini模型时，您需要在代码中初始化
Vertex AI Gemini API后端服务时明确指定 global 位置。
解决方法：初始化 Vertex AI Gemini API 服务时，
指定位置 global。详细了解如何
指定访问模型的位置
（包括代码段）。
位置无效（仅在使用 Vertex AI Gemini API 提供方时适用）
原因：您使用的模型在您尝试访问的位置不受支持。
如果您使用 Vertex AI Gemini API,
则某些模型仅在特定位置提供。
例如（但不限于）：
Imagen 模型在 不 支持 global
位置。
Gemini Live API 模型（例如 gemini-2.0-flash-live-preview-04-09）
仅在 us-central1
位置受支持。
Gemini 2.5 模型（例如 gemini-2.5-pro）仅在 global 位置、美国境内位置和部分欧洲位置提供（有时，如果您的项目具有特殊选项，则在其他位置也提供）。
解决方法：初始化 Vertex AI Gemini API 服务时，
请确保为使用的模型指定受支持的位置。详细了解如何
指定访问模型的位置
（包括代码段）以及
模型支持的位置。
请注意，Firebase AI Logic 默认使用
us-central1 位置。
429 错误: "You exceeded your current quota, please check your plan and billing details" 或 "Resource exhausted, please try again later."
429 错误表示您超出了配额，或者您访问的模型因其他人的请求而过载。
要采取的操作取决于您使用的是
Gemini Developer API 还是 Vertex AI Gemini API。如需详细了解配额以及如何申请额外配额，请参阅
速率限制和配额。
