WaveSpeedAI

fal.ai「User is locked」(Admin lock、Exhausted balance):含義與應對方法

您的 fal.ai 金鑰回傳 403「User is locked. Reason: Admin lock」或「Exhausted balance」。本文說明各原因的含義、如何解除鎖定,以及在此期間如何讓您的應用持續運行。

By WaveSpeedAI3 min read

如果你的 fal.ai 請求突然以 403 失敗,且回應內容寫著 User is locked,那麼被封鎖的是你的帳號,而不是你的請求。重試無法解除,而且在多數回報中,換新的 API key 也無法解除。接下來該怎麼做,取決於訊息中的原因:Exhausted balance 是帳務鎖定,儲值後應該就會解除;Admin lock 是 fal 端設下的鎖定,只有 fal 客服能夠移除。

本指南說明每種原因的含義、讓帳號最快解鎖的步驟順序,以及在等待期間如何讓你的產品持續運作。

資料來源查閱於 2026 年 11 月 22 日:fal 的文件,以及 GitHub 上 fal-ai/fal 儲存庫的公開 issue 追蹤。

錯誤訊息的樣子

API 會回傳 HTTP 403 以及一個 detail 字串。以下是公開回報中出現的三種變體:

{"detail": "User is locked. Reason: Exhausted balance. Top up your balance at fal.ai/dashboard/billing."}
{"detail": "User is locked. Reason: Admin lock. Please contact support@fal.ai."}
{"detail": "User is locked. Reason: TOP_UP."}
訊息中的原因含義誰能解除
Exhausted balance帳務鎖定。fal 的 FAQ 寫道:「When your credit balance drops below your account’s lock threshold, your account is locked and API requests will be rejected.」你自己,透過增加額度。若儲值後仍被鎖定,則需 fal 客服處理。
TOP_UPfal 文件中沒有說明。在回報中,它與 Exhausted balance 訊息出現在同一個帳號上,因此可視為同一種帳務鎖定。同上。
Admin lock由 fal 端設下的鎖定。訊息本身就要求你聯絡客服。fal 並未公開判定標準。只有 fal 客服。

開始之前,有兩個細節值得了解:

  • FAQ 談的是鎖定門檻,而不是零。儀表板上仍顯示幾美元,並不能證明你的餘額高於你帳號的門檻。
  • 同一份 FAQ 提到,採發票計費的企業客戶「are not subject to automatic locking」。如果不中斷的服務比隨用隨付的彈性更重要,這就是該向 fal 詢問的方案。

另一種 403:「Access denied」

並非 fal 的每個 403 都是帳號鎖定。如果回應內容寫的是存取遭拒,或你沒有權限使用某個端點,而且沒有 User is locked 的文字,那麼帳號是正常的,只是這把 key 或這個端點不被允許。fal 的驗證文件把這類 403 與 API key 的權限預設組合連結在一起。請檢查失敗的服務使用的是哪把 key,以及它是以什麼預設組合建立的。如果你這邊沒有任何變動,而整個端點系列突然拒絕昨天還能用的 key,那就應該向 fal 客服詢問,並附上端點 id 與完整的錯誤內容。

你並不孤單

fal-ai/fal 的 issue 追蹤中,2026 年 3 月至 11 月之間有超過 25 個關於帳號被鎖定的 issue。它們分為兩類。

餘額為正卻被鎖定。 使用者回報儀表板顯示有額度,卻出現 Exhausted balance 鎖定,例如 #922、#1112、#1163 和 #1269。在 #1163 中,回報者寫道帳號在手動解鎖幾分鐘後又再次被鎖定。

儲值後不久就被 Admin lock。 數則回報描述新帳號或少量使用的帳號在第一次付款後立刻被 admin lock,例如 #1183、#1248、#1254 和 #1281。另一則 #1061,來自一位在上線前的端對端測試期間用量暴增的開發者。

公平地說:這些只是個別回報,並不能衡量發生的頻率,而且在這些討論串中,fal 工作人員確認這些帳號都已由客服解鎖。#1281 的回報者在寄出電子郵件後的隔天就被解鎖。其他回報者則說他們等了好幾天才收到第一次回覆。工作人員也在這些討論串中表示,GitHub 並不負責處理帳號支援。

如何依序解鎖

1. 讀懂原因並停止重試

記錄完整的 403 內容。帳號被鎖定不是暫時性故障,所以請把它從你的重試路徑中移除。對被鎖定的帳號重試,只會塞滿你的佇列,並延誤該通知有人需要處理的警報。

import requests

class AccountLocked(Exception):
    pass

def check_fal_response(resp: requests.Response) -> None:
    if resp.status_code == 403 and "User is locked" in resp.text:
        # Not retryable: page a human and switch to the fallback provider.
        raise AccountLocked(resp.json().get("detail", resp.text))
    resp.raise_for_status()

2. 先檢查帳務

開啟帳務儀表板並確認三件事:額度餘額、沒有未付的發票,以及付款方式有效。如果原因是 Exhausted balance 或 TOP_UP,請增加額度。然後在幾分鐘後送出一個測試請求。

3. 用帳號的電子郵件寄信給客服

如果原因是 Admin lock,或帳務鎖定在儲值後仍未解除,fal 唯一指定的管道是 support@fal.ai,而且工作人員要求你使用被鎖定帳號的電子郵件地址來寫信。請在第一封信中就附上他們需要的所有資訊,以免來回浪費時間:

  • 帳號電子郵件,以及(若有使用的話)團隊名稱。
  • 完整的 detail 字串,以及第一次失敗請求的時間。
  • 你最近一次儲值的收據或發票編號。
  • 用一兩句話說明你的產品做什麼,以及用量為何改變(若有改變的話,例如上線、負載測試、新功能)。

4. 沒有幫助的做法

  • 更換 API key。 鎖定是在帳號上。建立了新 key 的回報者得到的仍是同樣的 403。
  • 開第二個帳號。 如果鎖定是出於付款或風險審查,在同一張信用卡下再開重複帳號,通常只會讓審查更慢,而不是更快。
  • 每天重複寄同一封信。 請在既有的郵件串中回覆,讓所有紀錄都留在同一張工單裡。
  • 用 GitHub issue 取代電子郵件。 這或許能增加能見度,但工作人員會關閉這類 issue 並引導到電子郵件。

如果你是團隊:一個帳號,而不是每人一個帳號

社群提問中常出現的一種模式是:公司給每位員工一個個人帳號,並用同一張信用卡為所有帳號儲值。許多新帳號由同一張卡付款,正是任何平台的付款風險系統都會設法偵測的情況。fal 文件中記載的做法是使用團隊:一個擁有獨立帳務的共用工作區,其中「API keys belong to the team, not to individual members」,管理員可透過電子郵件邀請成員,人數較多時可用 CSV 匯入。如果你的帳號已經因此被鎖定,請在寄給客服的信中坦白說明,並要求合併為一個團隊。

在等待期間讓你的產品持續運作

帳號鎖定是重試、退避和第二把 API key 都無法解決的故障。如果付費客戶依賴你的生成流程,實際的保護做法是準備第二個平台:它提供相同的模型系列,已經完成整合並儲值,且你能用一個設定開關切換過去。

幾條規則能讓維護成本很低:

  • 把模型選擇放在你自己的介面後面,讓呼叫端要求的是「文字生成圖像,1024 × 1024」,而不是某個供應商的 URL。
  • 把帳號層級的錯誤(被鎖定、被停權、額度用盡)與請求層級的錯誤分開歸類,並且只在前一類錯誤時才容錯移轉。
  • 每天讓一小部分真實流量經過備援。一個一個月都沒被呼叫過的備援,往往在你需要它的時候已經壞了。

使用 WaveSpeedAI 作為第二個平台

WaveSpeedAI 是一個隨用隨付的 API,涵蓋圖像、影片、音訊與 3D 模型。模型目錄涵蓋多數 fal 專案常用的系列,包括 Seedance、Kling、Wan、Veo、FLUX、Seedream 和 GPT Image。與這個問題有關的重點如下:

  • 每次請求都會檢查額度。 當帳號有足夠的額度時,請求就會被接受。儲值之後,下一個請求就能通過;沒有需要另外等待的解鎖步驟。
  • 額度用盡時有明確的訊息。 API 會回傳 Insufficient credits. Please top up your account to continue,讓你的程式碼能區分帳務問題與模型失敗。
  • 自動儲值。 你可以讓帳號在低於你設定的餘額時自動儲值,這能消除凌晨 3 點發生中斷最常見的原因。
  • 付款方式。 信用卡、PayPal、支付寶和微信支付。
  • 同一帳號下的團隊成員。 在儀表板中邀請隊友,讓所有人使用同一份餘額,而不是各自的個人帳號。
  • 執行前顯示價格。 每個模型頁面都會顯示你所設定請求的費用。

和所有平台一樣,WaveSpeedAI 也有使用條款與內容規範,請在轉移正式流量之前先閱讀。

請求的樣子

先提交一個任務,再用回傳的 id 取得結果。這個範例使用一個快速的文字生成圖像模型;目錄中的每個模型都遵循同樣的兩個呼叫。

curl --request POST 'https://api.wavespeed.ai/api/v3/wavespeed-ai/z-image/turbo' \
  --header "Authorization: Bearer $WAVESPEED_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"prompt": "A lighthouse on a cliff at sunrise, soft fog, 35mm photo"}'
curl --request GET "https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result" \
  --header "Authorization: Bearer $WAVESPEED_API_KEY"

第一個呼叫會回傳 data.id。第二個呼叫會回傳 data.status(created、processing、completed 或 failed),完成時則在 data.outputs 中提供檔案 URL。

從 fal 對應過來

在 fal 上在 WaveSpeedAI 上
提交到模型的佇列端點POST https://api.wavespeed.ai/api/v3/<model path>
輪詢請求狀態,然後取得結果GET https://api.wavespeed.ai/api/v3/predictions/<id>/result
Authorization: Key ... 標頭Authorization: Bearer ... 標頭
完成時的 Webhook支援;請參閱文件
Python 與 JavaScript 用戶端Python 與 JavaScript SDK,以及純 REST

部分模型在不同平台之間的輸入名稱並不相同,因此請查看每個模型頁面上的參數清單,而不要直接把 payload 複製過去。

如果你想在寫程式之前先在瀏覽器中測試,圖像生成器和影片生成器執行的是與 API 相同的模型。

FAQ

fal.ai 上的「User is locked. Reason: Admin lock」是什麼意思?

這表示帳號是被 fal 端鎖定,而不是被自動餘額檢查鎖定。訊息要求你聯絡 support@fal.ai。增加額度或建立新 key 都無法解除;必須由 fal 客服處理。

為什麼我的 fal 帳號明明還有額度,卻因「Exhausted balance」被鎖定?

fal 的 FAQ 指出,當餘額降到低於帳號專屬的鎖定門檻時就會觸發鎖定,而這個門檻不一定是零。另外,有不少公開回報描述儲值成功後鎖定仍然存在,這些情況都是由客服手動解除的。請先儲值,等幾分鐘,測試一次,然後寄信給客服。

fal 需要多久才會解鎖帳號?

沒有公布的時間。在公開討論串中,有些使用者在寄信後一天內就被解鎖,其他人則回報等了好幾天才收到第一次回覆。請以較長的情況來規劃。

為什麼 fal 會回傳「Access denied」或「You do not have permission to use this endpoint」?

那是權限錯誤,不是帳號鎖定。請檢查該請求所使用的 API key 的權限預設組合。如果 key 與你的程式碼都沒有變動,請把端點 id 與錯誤內容寄給 fal 客服。

同一張卡上的多個 fal 帳號會被鎖定嗎?

fal 並未公布其風險規則。許多帳號由同一張卡儲值,通常是付款風險檢查的常見觸發條件,而 fal 提供團隊功能,讓多人共用同一個帳務帳號,因此請改用團隊。

換新的 API key 或新帳號能解決嗎?

新 key 不行,因為鎖定是在帳號上。在第一個帳號仍在審查期間,開新帳號是個不好的主意。

如何避免任何平台上帳號鎖定所造成的停機?

保留一個已整合並已儲值的第二個供應商,將帳號層級的錯誤視為不可重試,並在發生這類錯誤時自動容錯移轉。在平台提供自動儲值的地方請開啟它,這樣餘額偏低就不會演變成帳號鎖定。

分享