WaveSpeedAI

付費 Gemini API 專案出現 Veo 429 RESOURCE_EXHAUSTED:原因與解決方法

即使您的 Gemini API 專案已啟用付費且配額顯示未使用,Veo 3.1 仍會回傳 429 RESOURCE_EXHAUSTED。本文說明六大成因、各自的檢查方式,以及另一種呼叫 Veo 的方法。

By WaveSpeedAI3 min read

如果在付費專案上,透過 Gemini API 呼叫 Veo 時出現 429 RESOURCE_EXHAUSTED,原因不外乎以下六種:Veo 的每日請求配額已用完、觸及以花費為基準的限制、金鑰屬於另一個專案而不是你升級的那個專案、預付餘額已空、你的使用層級與你以為的不同,或是專案的配額從一開始就沒有正確配置。前四種你可以自行解決,後兩種需要 Google 處理。

本指南說明如何區分這幾種情況,以及在等待期間可以怎麼做。

資料查證日期為 2026 年 11 月 22 日:Google 的 Gemini API 速率限制與疑難排解文件,以及下方連結的 Google AI Developers Forum 討論串。

錯誤訊息長什麼樣

429 RESOURCE_EXHAUSTED
You exceeded your current quota, please check your plan and billing details.

開發者回報在 veo-3.1-generate-preview、veo-3.1-fast-generate-preview 和 veo-3.1-lite-generate-preview 上都會遇到這個錯誤,而且同一把金鑰上的文字與圖像模型往往仍能正常運作。

Gemini API 的限制如何運作

Google 速率限制文件中的四項說明,可以解釋大多數情況:

  • 「速率限制是以專案為單位套用,而不是以 API 金鑰為單位。」
  • 「每日請求數(RPD)配額會在太平洋時間午夜重置。」
  • 「實驗版與預覽版模型的速率限制更為嚴格。」上述 Veo 3.1 模型都屬於預覽版模型。
  • 「所列的速率限制並不保證,實際容量可能有所變動。」

層級依帳單紀錄而定:

層級資格條件
Free一個啟用中的專案
Tier 1「設定並連結一個啟用中的帳單帳戶」
Tier 2「累計付款 $100,且距首次成功付款已滿 3 天」
Tier 3「累計付款 $1,000,且距首次成功付款已滿 30 天」

除了請求數限制之外,付費層級還有以 10 分鐘滾動視窗計算的花費限制,超過時同樣會回傳 429 RESOURCE_EXHAUSTED。影片是你能請求的項目中最貴的,因此短時間內連送幾個 Veo 任務,會比文字流量更快觸及花費限制。

六種原因

1. 你用完了 Veo 的每日配額

在論壇討論串中,Tier 1 專案的 Veo 限制是每個模型每分鐘 2 次請求、每天 10 次請求。十支影片,一個下午的測試就用完了。重試沒有用,計數器要到太平洋時間午夜才會重置。

2. 你觸及了花費限制

即使請求計數器還有空間,十分鐘內提交幾支影片也可能超過 Tier 1 的花費限制。請把任務間隔拉開,或升級到更高的層級。

3. 金鑰來自另一個專案

限制與層級是屬於專案的。如果你在某個專案上啟用了帳單,但程式碼用的是在另一個專案下建立的金鑰,那你適用的仍是另一個專案的限制。在同一個專案裡新建金鑰不會有任何改變。

4. 預付餘額已空

Google 論壇上針對 429 錯誤的建議指出,預付餘額耗盡同樣會讓回應中止。在查看配額之前,請先檢查餘額。

5. 層級與你付費購買的不一致

在一則 2026 年 8 月的討論串中,一位開發者的專案已被確認為 Tier 2,幾天後卻發現退回了 Tier 1,Veo 的每日限制從 50 降到 10,生成也隨之失敗。帳單支援團隊無法更改;討論串中有一則回覆指向一份用來回報非預期層級降級的表單,問題在兩天後獲得解決。

6. 配額顯示未使用,卻仍然收到 429

這是唯一沒有自助解法的情況。在一則 2026 年 9 月的討論串中,一位 Tier 1 開發者的預付餘額為正,儀表板上每個 Veo 模型都顯示 0/2 RPM 和 0/10 RPD,第一次請求卻仍然收到 429,而同一把金鑰上的其他 Gemini 呼叫都成功。另一位開發者也回報了相同的數字。唯一的回覆只是要求提供專案 ID 與一次失敗請求的時間。六月的較早討論串描述了每日配額超過 48 小時都沒有重置的情況,該討論串在沒有任何答覆的情況下被自動關閉。

依序檢查

  1. 金鑰屬於哪個專案? 在 AI Studio 中打開該金鑰,記下對應的專案。確認是這個專案(而非其他專案)已連結帳單。
  2. 該專案目前是哪個層級? 請從該專案的速率限制頁面查看,而不是看確認信。
  3. Veo 那一列顯示什麼? 如果 RPD 已達上限,請等到太平洋時間午夜。如果顯示未使用,請繼續往下查。
  4. 是否有預付餘額?是否已達到花費上限?
  5. 你是否在幾分鐘內送出了多個影片任務? 等十分鐘,然後只送一個。
  6. 配額顯示未使用卻仍然失敗? 請收集專案 ID、模型 ID、一次失敗請求的 UTC 時間,以及速率限制頁面的截圖。把這些資料貼到 Google AI Developers Forum;如果層級看起來不對,請使用上述討論串中提到的層級降級表單。Google 聲明:「我們不保證會提高您的速率限制。」

在程式碼中正確處理

Google 的疑難排解指南建議對 429 使用指數退避。這對每分鐘限制是正確的,但對每日限制毫無用處,因此請限制重試次數,然後停止。

import random
import time

def call_with_backoff(submit, max_attempts=4):
    for attempt in range(max_attempts):
        try:
            return submit()
        except Exception as err:
            if "RESOURCE_EXHAUSTED" not in str(err):
                raise
            if attempt == max_attempts - 1:
                # 每分鐘的限制在幾次重試內就會解除。
                # 如果還走到這裡,就是每日或帳戶層級的限制:
                # 停止重試,改走第二條路線。
                raise
            time.sleep(min(60, 2 ** attempt * 5) + random.random())

請用佇列處理影片任務,而不是平行送出,並且按太平洋時間的日期、為每個模型記錄請求次數的計數器,這樣你在 Google 通知你之前,就能知道自己快要碰到上限了。

呼叫 Veo 的另一種方式

如果你的產品依賴 Veo,而一天十次請求不夠用,你就需要第二條不經過同一個專案配額的路線。Google 自己的替代方案是 Vertex AI,它有獨立的配額,但需要設定 Google Cloud。

WaveSpeedAI 透過其 API 提供 Veo 3.1 和 Veo 3.1 Fast,支援文字生成影片與圖像生成影片:

  • 有點數的帳戶皆可使用。 不需要另外申請預覽版配額。
  • 按次計費。 你所選設定的價格會在執行前顯示於模型頁面。
  • 沒有冷啟動,失敗的任務會全額退款。
  • 一個 API 通用所有模型。 同樣的兩個呼叫適用於 Veo、Kling、Seedance、Wan 以及目錄中的其他模型,因此幾分鐘內就能加上第二個模型作為備援。
curl --request POST 'https://api.wavespeed.ai/api/v3/google/veo3.1-fast/text-to-video' \
  --header "Authorization: Bearer $WAVESPEED_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"prompt": "A paper boat drifting down a rain-soaked street at dusk, cinematic, shallow depth of field"}'
curl --request GET "https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result" \
  --header "Authorization: Bearer $WAVESPEED_API_KEY"

第一個呼叫會回傳 data.id;第二個呼叫會回傳 data.status,完成後則在 data.outputs 中回傳影片網址。速率限制取決於你的帳戶等級,並列在文件中。

如果想不寫程式碼就試用,請打開影片生成器。

常見問題

為什麼我的配額顯示已使用 0,Veo 卻出現 429 RESOURCE_EXHAUSTED?

可能的原因有三種:金鑰屬於另一個專案,而不是你正在查看配額的那個專案;花費限制或預付餘額已空擋下了請求;或是該專案的 Veo 配額運作不正常。2026 年有數位開發者在付費 Tier 1 專案上回報了最後一種情況,需要由 Google 檢查該專案。

Gemini API Tier 1 的 Veo 速率限制是多少?

Google 的速率限制頁面並未列出 Veo。根據 2026 年開發者的回報,Tier 1 儀表板上每個 Veo 模型顯示為每分鐘 2 次請求、每天 10 次請求。請在你自己專案的速率限制頁面查看目前的數字。

Veo 的每日配額什麼時候重置?

根據 Google 的文件,在太平洋時間午夜重置。

換一把新的 API 金鑰能解決 429 嗎?

如果新金鑰建在同一個專案裡,就不能。限制是以專案為單位,而不是以金鑰為單位。

如何取得更高的 Veo 限制?

透過付款紀錄升級到下一個層級(Tier 2 需要累計付款 $100,且距首次成功付款已滿三天),或提交 Google 的速率限制提升申請表單。Google 不保證一定會提高。

沒有 Gemini API 配額也能使用 Veo 嗎?

可以。Vertex AI 有自己的配額,而 WaveSpeedAI 等平台則透過各自的 API 提供 Veo 3.1,並採按次計費。

分享