iOS+
Android
網頁版
Flutter
本頁面提供 Gemini API 和 Vertex AI in Firebase SDK 的常見問題 (FAQ) 解答和疑難排解資訊。如有其他問題，請參閱 Google Cloud 說明文件中的 Gemini API 常見問題
一般常見問題
您必須啟用哪些 API 才能使用 Vertex AI in Firebase SDK？如何啟用這些功能？
如要使用 Vertex AI in Firebase SDK，您的專案必須啟用下列兩個 API：
您只要在 Firebase 控制台中按幾下滑鼠，即可啟用這些 API：
前往「運用 Gemini 建構內容 」頁面
按一下 Vertex AI in Firebase Vertex AI in Firebase API 新增至 Firebase API 金鑰的許可清單。
或者，您也可以使用 Google Cloud 主控台 (更多手動選項)：
按一下本常見問題項目頂端的每個 API 連結，然後在每個 API 頁面中按一下「啟用」
按照 Google Cloud 說明文件中的「新增 API 限制 」操作說明，將 Vertex AI in Firebase API 新增至 Firebase API 金鑰的許可清單。
使用 Vertex AI in Firebase SDK 需要哪些權限？
動作 必要的 IAM 權限 預設包含必要權限的 IAM 角色
升級至即付即用 (Blaze) 定價方案
firebase.billingPlans.updateresourcemanager.projects.createBillingAssignmentresourcemanager.projects.deleteBillingAssignment
擁有者
在專案中啟用 API
serviceusage.services.enable編輯者 擁有者
建立 Firebase 應用程式
firebase.clients.createFirebase 管理員 編輯者 擁有者
哪些型號可搭配 Vertex AI in Firebase SDK 使用？
我們會經常在 SDK 中新增功能，因此請回來看看這份常見問題清單 (以及發布說明、部落格和社群媒體貼文)，瞭解最新消息。
使用 Vertex AI in Firebase 時，這些功能是否可用？是否有使用內容快取、將搜尋做為工具、以 Google 搜尋建立基準、執行程式碼、微調模型、產生嵌入資料和語意檢索的功能？
各種模型或 Vertex AI Gemini API使用 Vertex AI in Firebase
如要將這些功能列為功能要求，或對現有功能要求進行投票，請前往 Firebase UserVoice 。
如何設定每位使用者的頻率限制？
根據預設，Vertex AI in Firebase 會將每位使用者的要求限制設為每分鐘 100 個要求 (RPM)。
如要調整每位使用者的速率限制，您必須調整 Vertex AI in Firebase API 的配額設定。
進一步瞭解 Vertex AI in 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 說明文件
如果出現提示，請按照終端機顯示的操作說明，針對 Firebase 專案執行 gcloud CLI 。
您需要 Firebase 專案 ID，可在 settings
專案設定 Firebase 主控台。
請執行下列指令，在專案中佈建必要的服務代理程式：
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 ''
請稍候幾分鐘，確保服務代理已佈建完成，然後再嘗試傳送包含 Cloud Storage for Firebase 網址的多模態要求。
如果等待幾分鐘後仍收到這則錯誤訊息，請與 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 控制台的「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 。針對 Vertex AI in Firebase ，API 金鑰的許可清單中至少必須包含 Vertex AI in Firebase API。
您可以在 Google Cloud 主控台的「API 和服務 」
注意： Firebase 相關 API 只會使用 API 金鑰識別 Firebase 專案或應用程式，不會用於授權 呼叫 API (如同其他 API 允許的情況)。Firebase 相關 API 的授權會透過 Google Cloud IAM 權限、Firebase Security Rules 或 Firebase App Check 與 API 金鑰分開處理。進一步瞭解 Firebase 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 控制台的「API 和服務 」
如果發現兩者不相符，請取得新的 Firebase 設定檔/物件 ，然後取代 應用程式中的設定檔。新的設定檔/物件應包含應用程式和 Firebase 專案的有效 API 金鑰。
針對 Vertex AI in Firebase 的使用體驗提供意見回饋
