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.8 Flash, are available to use with
Firebase AI Logic! Learn more.
Gemini 2.5 models will shut down in October 2026 (and new projects cannot start
using them). To avoid service disruptions, update to a newer model (like
gemini-3.8-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 is not valid. Please check your Firebase configuration.」API key not valid. Please pass a valid API key.，通常表示 Firebase 設定檔/物件中的 API 金鑰不存在，或未設定為與應用程式和/或 Firebase 專案搭配使用。
檢查 Firebase 設定檔/物件中列出的 API 金鑰，是否與應用程式的 API 金鑰相符。您可以在 Google Cloud 控制台的「APIs & Services」(API 和服務) >「Credentials」(憑證) 面板中，查看所有 API 金鑰。
如果發現不相符，請取得新的 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 網址。您必須是專案的擁有者，且專案只需要完成一次這組工作。
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 使用記錄的專案。
由於您未對 Firebase AI Logic 強制執行 App Check，您的專案容易遭到 Gemini API 濫用。為保護專案，Firebase 已停用 Firebase AI Logic 的使用權，直到您為 Firebase AI Logic 強制執行 App Check 為止。
403 錯誤：PERMISSION_DENIED: The caller does not have permission.
如果收到 403 錯誤，且錯誤訊息為「PERMISSION_DENIED: The caller does not have permission.」，通常表示 Firebase 設定檔/物件中的 API 金鑰屬於其他 Firebase 專案。
檢查 Firebase 設定檔/物件中列出的 API 金鑰，是否與應用程式的 API 金鑰相符。您可以在 Google Cloud 控制台的「APIs & Services」(API 和服務) >「Credentials」(憑證) 面板中，查看所有 API 金鑰。
如果發現不相符，請取得新的 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。
如要修正這個問題，請在 Google Cloud 控制台中更新 API 金鑰的限制，加入必要的 API。如要使用 Firebase AI Logic，請務必確認 Firebase AI Logic API (firebasevertexai.googleapis.com) 已列入可使用 API 金鑰呼叫的所選 API 清單。
步驟如下：
在 Google Cloud 控制台中，開啟「APIs & Services」(API 和服務) >「Credentials」(憑證) 面板。
選取應用程式設定使用的 API 金鑰 (例如 iOS 應用程式的「iOS 金鑰」)。
在「編輯 API 金鑰」頁面中，找到「API 限制」部分。
確認已選取「限制金鑰」選項。如果不是，代表金鑰不受限制，這可能不是錯誤來源。
。
在「選取的 API」下拉式選單中，搜尋並選取要新增的 Firebase AI Logic API，將其加入可使用 API 金鑰呼叫的 API 清單。
按一下 [儲存]。
變更最多可能需要五分鐘才會生效。
404 錯誤：Firebase AI Logic genai config not found
如果收到「Firebase AI Logic genai config not found」的 404 錯誤訊息，通常表示 Firebase AI Logic 的設定錯誤或遺漏。
造成這項錯誤最可能的原因如下：
您尚未為 Gemini API 供應商設定 Firebase 專案。
做法：
在 Firebase 控制台中，依序前往「AI Services」(AI 服務) >「AI Logic」(AI 邏輯)。按一下「開始使用」，然後選取您選擇的 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.」
