常見問題與疑難排解

為什麼名稱從「Vertex AI in Firebase」變更為「Firebase AI Logic」？

2024 年，我們推出了一系列 Firebase 用戶端 SDK，可使用 Vertex AI Gemini API，以及 Firebase 代理閘道，防止 API 遭到濫用，並與其他 Firebase 產品整合。我們將產品命名為「Firebase 中的 Vertex AI」，這個名稱準確描述了當時產品的可用用途。

不過，我們已擴充產品功能。舉例來說，自 2025 年 5 月起，我們開始支援 Gemini Developer API，包括透過與 Firebase App Check 整合，保護 Gemini Developer API 免於濫用。

因此，「Firebase 中的 Vertex AI」這個名稱已無法準確代表產品的擴大範圍。因此，我們將推出新名稱「Firebase AI Logic」，以更貼切地反映不斷演進的功能，並在未來持續擴大服務範圍！

請參閱遷移指南，確保您能使用 Firebase AI Logic 的所有最新功能 (並視需要開始使用 Gemini Developer API)。

使用 Gemini Developer API 和 Vertex AI Gemini API 有何不同？

以下是兩個「Gemini API」供應商之間的一些差異，無論您如何存取，一般而言都是如此：

• 定價

  • Gemini Developer API 提供「免費層級」和即付即用計價模式。

  • 搭配 Firebase AI Logic 使用 Vertex AI Gemini API 時，一律須採用即付即用 Blaze 定價方案。

  請注意，這兩家 API 供應商的隨用隨付價格不同 (詳情請參閱各自的說明文件)。

• 速率限制 (配額)

  • Gemini Developer API 設有明確的頻率限制。

  • Vertex AI Gemini API 使用「動態共用配額 (DSQ)」，該區域中所有使用該模型的用戶都會共用配額。您也可以選擇設定佈建輸送量 (PT)。

• 指定模型存取位置

  • 只有 Vertex AI Gemini API 可供選擇模型存取位置。

下表列出兩種「Gemini API」供應商的常見功能。下表適用於使用 Firebase AI Logic 用戶端 SDK 時。

¹ Gemini Developer API 的Files API 不支援透過 Firebase AI Logic SDK 使用。

如要在程式碼中切換 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 使用？

如需支援的機型清單，請參閱「瞭解支援的機型」。我們會經常在 SDK 中新增功能，因此請定期查看這份常見問題，瞭解最新消息 (以及版本說明、網誌和社群貼文)。

Gemini Developer API

您可以使用 Gemini 和 Imagen 基礎模型。

請注意，Gemini Developer API (無論存取方式為何) 僅支援使用 imagen-3.0-fast-generate-002 模型生成圖像。

Vertex AI Gemini API

您可以使用 Gemini 和 Imagen 基礎模型。

無論選擇哪種Gemini API供應商

Firebase AI Logic不支援下列項目：

• 非基礎模型Gemini (例如 PaLM 模型、微調模型或以 Gemma 為基礎的模型)。

• 舊版 Imagen 模型或 imagen-3.0-capability-001。

模型淘汰時的因應措施

我們發布穩定模型版本時，會盡力確保該版本至少可使用一年。我們會在 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 類型的情況

如果要求來自 Android 和 Apple 平台原生應用程式，則可例外不提供 MIME 類型。

Android 和 Apple 平台的 Firebase AI Logic SDK 提供簡化的平台友善方式，可處理要求中的圖片。所有圖片 (無論格式為何) 都會在傳送至伺服器前，於用戶端轉換為品質 80% 的 JPEG。也就是說，使用 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 搜尋做為工具、以 Google 搜尋建立基準、程式碼執行、微調模型、生成嵌入內容，以及語意檢索？

各種模型或 Vertex AI Gemini API 支援脈絡快取、將搜尋當做工具、以 Google 搜尋建立基準、程式碼執行、微調模型、產生嵌入內容和語意檢索，但使用 Firebase AI Logic 時無法使用這些功能。

如要將這些項目新增為功能要求，或對現有的功能要求投下贊成票，請前往 Firebase UserVoice。

什麼是 Gemini API 金鑰？

Gemini Developer API 會使用「Gemini API 金鑰」授權呼叫端。因此，如果您使用 Gemini Developer API SDK，Firebase 專案中必須有有效的 Gemini API 金鑰，才能呼叫該 API。Gemini Developer APIFirebase AI Logic

「Gemini API 金鑰」只是指 API 許可清單中包含 Gemini Developer API 的 API 金鑰。

在 Firebase 控制台中完成Firebase AI Logic設定工作流程時，我們會建立僅限 Gemini Developer API 使用的 Gemini API 金鑰，並設定 Firebase AI Logic Proxy 服務來使用這組 API 金鑰。這個 Firebase 產生的 API 金鑰在 Google Cloud 控制台的憑證頁面中，會命名為「Gemini Developer API key (auto created by Firebase)」。Gemini

進一步瞭解API 金鑰的 API 限制。

使用 Firebase AI Logic SDK 時，請勿將 Gemini API 金鑰加入應用程式的程式碼集。進一步瞭解如何確保 Gemini API 金鑰安全無虞。

我應該在行動或網路應用程式的程式碼庫中加入 GeminiAPI 金鑰嗎？

使用 Firebase AI Logic SDK 時，請勿將 Gemini API 金鑰加入應用程式的程式碼庫。

事實上，使用 Firebase AI Logic SDK 進行開發時，您不會直接與 Gemini API 金鑰互動。我們的 Firebase AI Logic Proxy 服務會在每個對 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 控制台的「APIs & Services」(API 和服務) >「Credentials」(憑證) 面板中刪除這個 API 金鑰。名稱為：
   Gemini Developer API 金鑰 (由 Firebase 自動建立)。

2. 在 Google Cloud 控制台的同一頁面中，建立新的 API 金鑰。建議將其命名為「Gemini Developer API key for Firebase」
   。

3. 為這個新 API 金鑰新增 API 限制，然後只選取 Generative Language API。
   「Generative Language API」有時會在 Google Cloud 控制台中稱為 Gemini Developer API。

   請勿新增任何應用程式限制，否則 Firebase AI Logic Proxy 服務將無法正常運作。

4. 執行下列指令，將這個新金鑰設為 Firebase AI Logic Proxy 服務應使用的 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 的 Firebase 設定檔案或物件中列出的 API 金鑰。如果只將金鑰用於 Firebase 相關 API (例如 Firebase AI Logic)，則可將 Firebase API 金鑰納入程式碼。 瞭解 Firebase API 金鑰的重要資訊。

在 Google Cloud 控制台的「APIs & Services」(API 和服務) >「Credentials」(憑證) 面板中，Firebase API 金鑰如下所示：

由於您必須將 Firebase API 金鑰加入應用程式的程式碼集，Firebase 相關 API 才能運作，且 Gemini Developer API 是透過 API 金鑰授權，因此強烈建議您不要將 Gemini Developer API (在 Google Cloud 控制台中稱為「Generative Language API」) 加入 Firebase API 金鑰的 API 允許清單。這麼做會讓 Gemini Developer API 暴露在潛在的濫用風險中。

如何確保 Gemini API 金鑰安全無虞？

這份常見問題說明建議的最佳做法，可確保 Gemini API 金鑰安全無虞。

如果您要直接從行動或網路應用程式呼叫 Gemini Developer API：

• 使用 Firebase AI Logic 用戶端 SDK。
• 請勿將 Gemini API 金鑰加入應用程式的程式碼集。

Firebase AI Logic 提供 Proxy 服務，會在每個對 Gemini Developer API 的要求中，於內部加入您的 Gemini API 金鑰，完全在後端進行。

此外，我們強烈建議您採取下列行動：

• 開始認真開發應用程式後，請整合 Firebase App Check，協助保護後端資源和用於存取生成模型的 API。

• 請勿在 Gemini 以外的地方重複使用 Firebase 產生的 Firebase AI Logic API 金鑰。如需Gemini其他用途的 API 金鑰，請另外建立金鑰。

• 一般來說，您「不應」修改 Firebase 產生的 GeminiAPI 金鑰。這組金鑰在 Google Cloud 控制台中名為「Gemini Developer API key (auto created by Firebase)」。

  • 請勿將任何其他 API 新增至 Firebase 產生的 Gemini API 金鑰 API 許可清單。在 API 許可清單中，您的 API 金鑰只能有 Gemini Developer API (在控制台中稱為「Generative Language API」Google Cloud)。Gemini

  • 請勿新增任何應用程式限制，否則 Firebase AI Logic Proxy 服務將無法正常運作。

我的 GeminiAPI 金鑰遭到盜用。我需要做些什麼？

如果 Gemini API 金鑰遭駭，請按照操作說明變更用於呼叫 Gemini Developer API 的 Gemini API 金鑰。

此外，請參閱建議的最佳做法，確保 Gemini API 金鑰安全無虞。

如何修正這個 404 錯誤？Firebase AI Logic genai config not found

如果您嘗試使用 Gemini Developer API，但收到 404 錯誤訊息 Firebase AI Logic genai config not found，通常表示您的 Firebase 專案沒有可與 Firebase AI Logic 用戶端 SDK 搭配使用的有效 Gemini API 金鑰。

造成這項錯誤最可能的原因如下：

• 您尚未為「Gemini Developer API」設定 Firebase 專案。

  解決方法：
  前往 Firebase 控制台的「Firebase AI Logic」頁面。按一下「開始使用」，然後選取「Gemini Developer API」。啟用 API 後，控制台會為 Gemini Developer API 設定專案。完成工作流程後，請再次提出要求。

• 如果您最近才在 Firebase 控制台中完成 Firebase AI Logic 設定工作流程，則 Gemini API 金鑰可能尚未在所有區域的所有必要後端服務中啟用。

  解決方法：
  請稍候片刻，然後再試一次。

• 您的 Gemini API 金鑰可能已從 Firebase 專案中刪除。

  解決方法：
  瞭解如何變更 Gemini Firebase AI Logic 使用的 API 金鑰。

如何修正這個 400 錯誤？Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.

如果您嘗試使用 Cloud Storage for FirebaseURL 傳送多模態要求，可能會遇到下列 400 錯誤：
Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.

如果專案啟用 Vertex AI API 時，未正確自動佈建必要的服務代理，就會發生這個錯誤。這是部分專案的已知問題，我們正在設法全面修正。

以下是解決專案問題的替代方案，可正確佈建這些服務代理程式，讓您開始在多模態要求中加入 Cloud Storage for Firebase 網址。您必須是專案的擁有者，且專案只需要完成一次這組工作。

1. 使用 gcloud CLI 存取及驗證。
   最簡單的方法是透過 Cloud Shell 執行這項操作。詳情請參閱Google Cloud說明文件。

2. 如果系統出現提示，請按照終端機顯示的指示，針對 Firebase 專案執行 gcloud CLI。

   您需要 Firebase 專案 ID，可在 Firebase 控制台的「專案設定」頁面頂端找到。settings

3. 執行下列指令，在專案中佈建必要的服務代理程式：

   curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"  https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/endpoints -d ''
   

4. 請稍候幾分鐘，確認服務代理程式已佈建完成，然後重試傳送包含 Cloud Storage for Firebase URL 的多模態要求。

如果等待幾分鐘後仍收到這則錯誤訊息，請與 Firebase 支援團隊聯絡。

如何修正這個 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 金鑰相符。您可以在 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 加入允許清單。

請確認應用程式使用的 API 金鑰，已將所有必要 API 列入金鑰的「API 限制」允許清單。如要使用 Firebase AI Logic，API 金鑰的允許清單中至少要有 Firebase AI Logic API。

您可以在 Google Cloud 控制台的「APIs & Services」(API 和服務) >「Credentials」(憑證) 面板中，查看所有 API 金鑰。

如何修正這個 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 金鑰。