如要使用 Firebase AI Logic,專案必須啟用所選的Gemini API供應商,但您也需要啟用 Firebase AI Logic API,因為這是我們用戶端 SDK 與 Gemini API 供應商之間的閘道。在 Firebase 專案中首次設定 Firebase AI Logic 時,系統會為您啟用這項 API。
您可以將 Firebase AI Logic API 速率限制 (配額) 設為應用程式的「每位使用者」速率限制,特別是針對依賴 Firebase AI Logic 的 AI 功能。您應設定這項限制,確保單一使用者能合理存取 AI 功能,同時避免單一使用者超出 Gemini API 供應商的限制 (所有使用者共用)。
「每位使用者」速率限制的詳細資料
以下是 Firebase AI Logic API 速率限制 (配額) 的幾項重要細節,特別是每分鐘要求數 (RPM):
費用是根據「生成內容要求」計算,以每位使用者、每個區域每分鐘為單位,不會因模型而異。
這項限制適用於專案層級,以及使用該 Firebase 專案的所有應用程式和 IP 位址。
這項限制適用於來自任何 Firebase AI Logic SDK 的呼叫。
預設的頻率限制為每位使用者每分鐘 100 個要求。
請注意,您仍須考量 Gemini API 供應商的限制 (見上文),
這些限制的優先順序高於 Firebase AI Logic API。
[null,null,["上次更新時間:2025-08-19 (世界標準時間)。"],[],[],null,["\u003cbr /\u003e\n\n\n|-------------------------------------------------------------------------------------------------------------------------------------|\n| *Click your Gemini API provider to view provider-specific content and code on this page.* Gemini Developer API Vertex AI Gemini API |\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nRate limits (commonly called quotas) regulate the number of requests you can\nmake to the Gemini API within a given timeframe. These limits help ensure\nfair usage, protect against abuse, and help maintain system performance for all\nusers.\n\nWhen using Firebase AI Logic to send requests to Gemini and\nImagen models, your project's rate limits depend on your chosen\n\"Gemini API\" provider. Firebase AI Logic also provides a way to\n[set \"per user\" rate limits](#per-user-rate-limits).\n\n[View rate limits for the Gemini Developer API](https://ai.google.dev/gemini-api/docs/rate-limits)\n| The rate limits (like requests per minute (RPM)) that are listed in the documentation are the *maximum* that the Gemini Developer API supports.\n|\n| The *actual maximum quota\n| **available to your Firebase project** and the model that\n| you're using* are dependent on several factors (for example,\n| the standing of your linked Cloud Billing account and capacity of the\n| overall system).\n\nHow rate limits (quotas) work\n\nRate limits (quotas) are measured across four dimensions:\n\n- Requests per minute (RPM)\n- Requests per day (RPD)\n- Tokens per minute (TPM)\n- Tokens per day (TPD)\n\nYour usage is evaluated against each limit, and exceeding any of them will\ntrigger a 429 quota-exceeded error. For example, if your RPM limit is 20, then\nmaking 21 requests within a minute will result in an error, even if you haven't\nexceeded your TPM or other limits.\n\nRate limits are applied at the project-level and apply to all applications and\nIP addresses that use that Firebase project.\n\nLimits vary depending on the specific model being used, and some limits only\napply to specific models. For example, images per minute (IPM) is only\ncalculated for models capable of generating images (Imagen 3), but is\nconceptually similar to TPM.\n\nRate limits are more restricted for experimental and preview models.\n\nRequest a rate limit increase\n\nIf you're on a \"paid tier\" for the Gemini Developer API, then you can\n[request a rate limit increase](https://ai.google.dev/gemini-api/docs/rate-limits#request-rate-limit-increase).\n\nSet \"per user\" rate limits\n\nTo use Firebase AI Logic, your project needs your chosen\nGemini API provider enabled, but you also need the\n[Firebase AI Logic API](https://console.cloud.google.com/apis/library/firebasevertexai.googleapis.com?project=_) enabled,\nwhich acts as a gateway between our client SDKs and your Gemini API\nprovider. This API is enabled for you when you initially set up\nFirebase AI Logic in your Firebase project.\n\n**You can use the Firebase AI Logic API rate limit (quota) as a\n\"per user\" rate limit for your app** , specifically for the AI features that rely\non Firebase AI Logic. You should\n[set this limit](#edit-quota-or-request-quota-increase) to reasonably\naccommodate a single user accessing your AI features, while also ensuring that\nno single user overwhelms the limits of your Gemini API provider (which is\nmeant to be shared by all your users).\n| **Note:** The Firebase AI Logic API rate limit is set quite high by default (100 RPM) to be usable for any app's use case. We recommend that you [adjust this rate limit](#edit-quota-or-request-quota-increase) to meet the actual needs of your app and use case.\n\nDetails about the \"per user\" rate limit\n\nHere are some important details about the Firebase AI Logic API\nrate limits (quotas) -- specifically, requests per minute (RPM):\n\n- It's based on \"Generate content requests\"\n on a per-user per-region per-minute basis, and it's *not* based on model.\n\n- It applies at the project-level and applies to all applications and IP\n addresses that use that Firebase project.\n\n- It applies to any call that specifically comes from any\n Firebase AI Logic SDK.\n\n- The default rate limit is 100 RPM per user. \n\n Note that you still need to consider the\n limits for your Gemini API provider (see above),\n which take precedence over the Firebase AI Logic API.\n\nAdjust the \"per user\" rate limit\n\nTo adjust a rate limit (quota), you must have the `serviceusage.quotas.update`\npermission, which is included by default in the Owner and Editor role.\n\nHere's how to edit your rate limit (quota) or request an increase:\n\n1. In the Google Cloud console, go to the page for the\n [Firebase AI Logic API](https://console.cloud.google.com/apis/library/firebasevertexai.googleapis.com?project=_).\n\n2. Click **Manage**.\n\n3. Lower on the page, click the **Quotas \\& System Limits** tab.\n\n4. Filter the table to show the quotas of interest, like the capability\n (requests for generating content) and region.\n\n For example, to view the per-user quotas for generating content requests\n in any of the supported Asian regions, your filter would look similar to\n this:\n `Generate content requests` + `Dimension:region:asia`\n | **Note:** To create a `Dimension` filter, you need to use the filter tooling, rather than just copy-pasting the values in this example above. Also, the `(default)` quota row doesn't apply to Firebase AI Logic.\n5. Select the checkbox to the left of each quota of interest.\n\n6. At the end of the quota's row, click\n more_vert,\n and then select **Edit quota**.\n\n7. In the **Quota changes** form, do the following:\n\n 1. Enter the increased quota in the *New value* field.\n\n This quota applies at the project-level and is shared across\n all applications and IP addresses that use that Firebase project.\n 2. Complete any additional fields in the form, and then click **Done**.\n\n 3. Click **Submit request**."]]