fal API error
User is locked. Reason: Exhausted balance. Top up your balance at fal.ai/dashboard/billing.
fal sends this as the detail of a 403 response when the account's balance is spent.
fal locked the account.
The balance ran out.
What it means
fal locks an account when its balance reaches zero, and API calls answer 403 until the lock clears. A top-up is meant to clear it.
The unlock can lag. In fal issue 922 an account stayed locked with a positive balance on the dashboard, and others reported the same.
Fix it
- Top up at fal.ai/dashboard/billing, as the message says.
- If the balance is positive and the lock stays, wait a few hours. One reporter on the issue was unlocked that way.
- Create a new API key and use it. One reporter cleared the lock this way. Another tried it and it did not help.
- If the lock still holds, contact fal support with your account name.
With superbot
superbot cannot unlock a fal account. That is fal's to do.
When a media call hits a spent fal balance, superbot books it as out of credit. It does not retry that route, and moves to another route when there is one.
With no fal key of your own connected, a media call runs on superbot's own key, so your fal balance is not in play. With your own key connected, it runs on yours.
Related
Source: fal-ai/fal issue 922: Account locked despite positive balance. Read on 2026-10-18.