本頁面提供 Gemini API 和 Firebase AI Logic SDK 的常見問題解答和疑難排解資訊。
如要排解錯誤代碼,請參閱「錯誤代碼」一節。
狀態資訊主頁
Vertex AI Gemini API (
Vertex Gemini API和Vertex Imagen API)
一般常見問題
為什麼名稱從「Vertex AI in Firebase」變更為「Firebase AI Logic」?
我們在 2024 年推出了一系列 Firebase 用戶端 SDK,可使用 Vertex AI Gemini API,以及 Firebase Proxy Gateway,保護該 API 免於濫用,並與其他 Firebase 產品整合。我們將產品命名為「Vertex AI in Firebase」,這個名稱當時確實能準確描述產品的可用用途。
不過,我們已擴充產品功能。舉例來說,自 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 | Vertex AI Gemini API | |
|---|---|---|
| 定價 | 免付費的 Spark 定價方案和即付即用的 Blaze 定價方案1皆適用這項功能 | 一律須採用即付即用 Blaze 定價方案1 (搭配使用時) Firebase AI Logic |
| 速率限制 (配額) | 明確的速率限制 | 使用動態共用配額 (DSQ),該區域中所有使用該模型的用戶都會共用配額。可使用佈建的處理量 (PT)。 |
| 指定模型存取位置 | API 不支援 | API 支援的格式 |
| 支援 Cloud Storage 網址 | API 2 不支援 |
公開檔案和 受 Firebase Security Rules 保護的檔案 |
| 支援 YouTube 網址和瀏覽器網址 | 僅限 YouTube 網址 | YouTube 網址和瀏覽器網址 |
1 這兩家 API 供應商的隨用隨付定價不同 (詳情請參閱各自的說明文件)。
2 Gemini Developer API 的檔案 API 不支援透過 Firebase AI Logic SDK 存取。
下表列出兩家「Gemini API」供應商提供的常見功能。這個表格僅適用於使用 Firebase AI Logic 用戶端 SDK 的情況。
| 功能 | Gemini Developer API | Vertex AI Gemini API |
|---|---|---|
| 支援 Gemini 模型 | 支援 | 支援 |
| Gemini Live API 支援服務 | 支援 | 支援 |
| 與 Firebase App Check 整合 | 支援 | 支援 |
| 適用於 Firebase Remote Config | 支援 | 支援 |
| 支援在 Firebase 控制台中監控 AI | 支援 | 支援 |
我可以同時使用 Gemini Developer API 和 Vertex AI Gemini API 嗎?
可以。您可以在 Firebase 專案中同時啟用「Gemini API」供應商,並在應用程式中使用這兩個 API。
如要在程式碼中切換 API 供應商,請務必在程式碼中適當設定後端服務。
需要哪些 API?如何啟用這些功能?
|
選取 Gemini API 供應商,查看特定供應商的內容 |
如要搭配 Firebase AI Logic SDK 使用 Vertex AI Gemini API,專案必須啟用下列兩項 API:
- Vertex AI API (
aiplatform.googleapis.com) - Firebase AI Logic API (
firebasevertexai.googleapis.com)
您可以透過下列任一方式啟用這些 API:
選項 1 (建議):在 Firebase 控制台中按幾下滑鼠,即可啟用 API:
前往 Firebase 控制台的「Firebase AI Logic」頁面。
按一下「開始使用」。
選取即可開始使用 Vertex AI Gemini API。
系統會啟動導覽工作流程,為您啟用這兩項 API。控制台也會將 Firebase AI Logic API 加入 Firebase API 金鑰的許可清單。
方法 2 (手動;不建議):在 Google Cloud 控制台中啟用 API:
按一下本常見問題條目頂端的各個 API 連結,然後在每個 API 的頁面中點選「啟用」。
將 Firebase AI Logic API 新增至 Firebase API 金鑰的允許清單。
如何停用 Firebase 專案中的 API?
對於 Firebase AI Logic,我們會盡量簡化設定 Firebase 專案的程序,讓您能輕鬆使用所選的 Gemini API 供應商。包括在特定流程中 (例如 Firebase 控制台的導覽工作流程),啟用 Firebase 專案中的必要 API。
不過,如果您決定不使用 Firebase AI Logic 或其中一個 Gemini API 供應商,可以在 Firebase 專案中停用相關聯的 API。
停用與使用 Gemini Developer API 相關聯的 API
如要搭配 Firebase AI Logic SDK 使用 Gemini Developer API,專案必須啟用下列兩項 API:
- Gemini Developer API (
generativelanguage.googleapis.com) - Firebase AI Logic API (
firebasevertexai.googleapis.com)
如要完全停止使用 Firebase AI Logic:
按一下上方的各個 API 連結,前往控制台中的相應 API 頁面,然後按一下「管理」。Google Cloud
查看「指標」分頁,確認 API 沒有用量。
如要停用 API,請點選頁面頂端的「停用 API」。
從可使用 Firebase API 金鑰呼叫的 API 清單中,移除 Firebase AI Logic API。如要瞭解如何修改這份清單,請參閱這篇 Firebase API 金鑰許可清單常見問題。
如要繼續使用 Firebase AI Logic,但改用 Vertex AI Gemini API:
前往 Google Cloud 控制台的「Gemini Developer API」頁面,然後按一下「管理」。
查看「指標」分頁,確認 API 沒有用量。
如要停用 API,請點選頁面頂端的「停用 API」。
停用與使用 Vertex AI Gemini API 相關聯的 API
如要搭配 Firebase AI Logic SDK 使用 Vertex AI Gemini API,專案必須啟用下列兩項 API:
- Vertex AI API (
aiplatform.googleapis.com) - Firebase AI Logic API (
firebasevertexai.googleapis.com)
如要完全停止使用 Firebase AI Logic:
按一下上方的各個 API 連結,前往控制台中的相應 API 頁面,然後按一下「管理」。Google Cloud
查看「指標」分頁,確認 API 沒有用量。
如要停用 API,請點選頁面頂端的「停用 API」。
從可使用 Firebase API 金鑰呼叫的 API 清單中,移除 Firebase AI Logic API。如要瞭解如何修改這份清單,請參閱這篇 Firebase API 金鑰許可清單常見問題。
如要繼續使用 Firebase AI Logic,但改用 Gemini Developer API:
前往 Google Cloud 控制台的「Vertex AI API」頁面,然後按一下「管理」。
查看「指標」分頁,確認 API 沒有用量。
如要停用 API,請點選頁面頂端的「停用 API」。
哪些模型可搭配 Firebase AI Logic SDK 使用?
請參閱支援的型號清單。 我們會經常在 SDK 中新增功能,因此請隨時返回這份常見問題清單查看最新消息 (以及版本說明、網誌和社群貼文)。
Gemini Developer API
Gemini 和 Imagen 基礎模型。
請注意,Gemini Developer API (無論存取方式為何) 僅支援特定穩定版 Imagen 模型。
Vertex AI Gemini API
- Gemini 和 Imagen 基礎模型。
無論選擇哪種Gemini API供應商
Firebase AI Logic不支援下列項目:
非基礎模型 Gemini (例如 PaLM 模型、微調模型或以 Gemma 為基礎的模型)。
舊版 Imagen 型號或
imagen-3.0-capability-001。
模型停止服務 (淘汰) 時該怎麼辦?
我們發布穩定版模型時,會盡量確保模型至少有一年的使用期限,再予以淘汰。
如何查看模型停用日期?
以下提供幾種查詢模型終止服務日期的方法:
發布時:我們會在 Gemini API 提供者說明文件和 Firebase 說明文件中的多個位置,列出各模型的預計停用日期 (請參閱支援的模型頁面)。
停用日期將近時:Google 會傳送電子郵件給適當的專案成員,並在版本說明和其他管道中發布提醒,說明即將停用的項目 (例如 Gemini 1.5 和 1.0 穩定版模型停用日期提醒)。
如果使用的模型即將停用,該怎麼辦?
請在服務終止前更新應用程式使用的模型名稱,否則對該模型提出的任何要求都會失敗,並顯示 404 錯誤。
建立
GenerativeModel、LiveModel或ImagenModel執行個體時,您可以在初始化期間設定模型名稱。 請務必詳閱下方的重大建議,瞭解如何使用 Firebase Remote Config。使用 Firebase AI Logic 時,您通常不需要修改任何實際呼叫模型的程式碼。
測試應用程式,確保回應仍符合預期。
Imagen 穩定模型 - 停用日期和替代方案
- 所有 Imagen 模型將於 2026 年 6 月 24 日停止服務。
替代方案: 將應用程式遷移至 Gemini 圖像模型 (「Nano Banana」模型)。
Gemini 2.0 穩定模型 - 停用日期和替代方案
Gemini 2.0 Flash 和 Gemini 2.0 Flash‑Lite:
gemini-2.0-flash-001(及其自動更新的別名gemini-2.0-flash)
gemini-2.0-flash-lite-001(及其自動更新的別名gemini-2.0-flash-lite)2026 年 2 月 6 日:如果專案先前未使用過這些模型,將無法再使用。
2026 年 3 月 31 日:這些模型將停止服務。
請注意,穩定版 Gemini Live API 2.0 模型不受影響。
替代方案:改用 Gemini 2.5 模型 (例如 gemini-2.5-flash-lite),或試用新的 Gemini 3 模型 (例如 gemini-3.1-flash-lite-preview)。
Gemini 1.5 和 1.0 穩定模型 - 停止服務日期和替代模型
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 日)
替代方案:改用 Gemini 2.5 模型 (例如 gemini-2.5-flash-lite),或試用新的 Gemini 3 模型 (例如 gemini-3.1-flash-lite-preview)。
如何設定每位使用者的頻率限制?
根據預設,Firebase AI Logic 會將每位使用者的要求限制設為每分鐘 100 個要求 (RPM)。
如要調整每位使用者的速率限制,請調整 Firebase AI Logic API 的配額設定。
進一步瞭解 Firebase AI Logic API 配額。您也可以在該頁面瞭解如何查看及編輯配額。
使用 Firebase AI Logic SDK 可能需要哪些權限?
| 動作 | 必要的 IAM 權限 | 預設包含必要權限的 IAM 角色 |
|---|---|---|
| 將帳單升級至即付即用 (Blaze) 定價方案 | firebase.billingPlans.updateresourcemanager.projects.createBillingAssignmentresourcemanager.projects.deleteBillingAssignment
|
擁有者 |
| 在專案中啟用 API | serviceusage.services.enable |
編輯者 擁有者 |
| 建立 Firebase 應用程式 | firebase.clients.create |
Firebase 管理員 編輯者 擁有者 |
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 時是否能使用這些功能?脈絡快取、模型微調、嵌入生成和語意檢索?
下列功能由各種模型和 API 供應商支援,但使用 Firebase AI Logic 時無法使用:
- 脈絡快取
- 微調模型
- 生成嵌入
- 語意擷取
如要將這些項目新增為功能要求,或對現有的功能要求投下贊成票,請前往 Firebase UserVoice。
在 Apple 平台上使用 Swift 應用程式時,模組名稱從 FirebaseAI 變更為 FirebaseAILogic,該怎麼辦?
如果是 Apple 平台應用程式,自 Firebase SDK 12.5.0 版起,
Firebase AI Logic 現在會透過 FirebaseAILogic 模組發布。
我們已進行這項變更,確保不會造成中斷,且具備回溯相容性。
異動原因
我們先前是透過 FirebaseAI 模組發布這項服務。但基於下列原因,我們必須將其重新命名為 FirebaseAILogic:
避免模組和類別之間發生名稱衝突,導致二進位發布作業發生問題。
讓我們能使用 Swift 巨集開發未來功能。
如果升級至 12.5.0 以上版本,該怎麼做?
模組名稱變更為 FirebaseAILogic 後,不會造成破壞性影響,且具備回溯相容性。不過,我們最終可能會在日後發布重大 Firebase SDK 中斷性變更時,一併移除舊模組(目前尚未確定時間範圍)。
您不需要因應這項模組名稱變更採取任何行動,但我們建議您採取下列行動:
選擇 Swift PM 依附元件時,請選擇
FirebaseAILogic(而非FirebaseAI)。將匯入陳述式變更為
FirebaseAILogic(而非FirebaseAI)。
Gemini API 金鑰常見問題
這些常見問題僅適用於使用 Gemini Developer API 的情況。
什麼是 Gemini API 金鑰?
Gemini Developer API 會使用「Gemini API 金鑰」授權呼叫端。因此,如果您使用 Gemini Developer API Firebase AI Logic SDK,Firebase 專案中就必須有有效的 Gemini API 金鑰,才能呼叫該 API。
「Gemini API 金鑰」只是指 API 許可清單中包含 Gemini Developer API 的 API 金鑰。
在 Firebase 控制台中完成Firebase AI Logic設定工作流程時,我們會建立 Gemini API 金鑰,並將其限制為只能用於 Gemini Developer 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 金鑰,請按照下列步驟操作:
如果 Firebase 產生的 Gemini API 金鑰仍然存在,請刪除該金鑰。
您可以在 Google Cloud 控制台的「API 和服務」>「憑證」面板中刪除這個 API 金鑰。名稱為:
Gemini Developer API 金鑰 (由 Firebase 自動建立)。在 Google Cloud 控制台的同一頁面中,建立新的 API 金鑰。建議將其命名為「Gemini Developer API key for Firebase」
。為這個新 API 金鑰新增 API 限制,並只選取 Generative Language API。
「Generative Language API」有時會在 Google Cloud 控制台中稱為 Gemini Developer API。請勿新增任何應用程式限制,否則 Firebase AI Logic Proxy 服務將無法正常運作。
執行下列指令,將這個新金鑰設為 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 產生的 Gemini API 金鑰。這組金鑰在 Google Cloud 控制台中名為「Gemini Developer API key (auto created by Firebase)」。
請勿將任何其他 API 新增至 Firebase 產生的 Gemini API 金鑰 API 許可清單。在 API 許可清單中,您的 Gemini API 金鑰只能有 Gemini Developer API (在 Google Cloud 控制台中稱為「Generative Language API」)。
請勿新增任何應用程式限制,否則 Firebase AI Logic Proxy 服務將無法正常運作。
我的 GeminiAPI 金鑰遭到盜用。我需要做些什麼?
如果 Gemini API 金鑰遭駭,請按照操作說明變更用於呼叫 Gemini Developer API 的 Gemini API 金鑰。
此外,請參閱建議的最佳做法,確保 Gemini API 金鑰安全無虞。
提供有關 Firebase AI Logic 的使用體驗意見回饋