Skip to main content
Spending controls help you monitor and limit your usage costs on fal. There are two types of control.
  • An alert notifies you when your usage costs cross a threshold in a daily, weekly, or monthly period.
  • A lock blocks new requests. Requests that are already running continue to completion.
You can set a control on a whole team, on one API key, or on one team member. Members with the Admin or Billing role can manage spending controls. In an organization with cross-team visibility, these members can manage the controls for every team from one page.
fal must enable spending controls for your account. fal enables locks separately. Contact support@fal.ai to request access.
Open Spending Controls from Settings > Usage & Billing.
The Spending controls page with the Add alert and Add lock buttons

Set Up an Alert

  1. Click Add alert.
  2. In an organization, select the team.
  3. Select the subject. The subject is the whole team, one API key, or one member.
  4. Select the period.
  5. Enter the threshold amount.
  6. Optional: turn on Auto-lock to block new requests when costs reach the threshold.
  7. Click Create alert.
The chart in the panel shows the costs for the last two periods. Use it to compare the threshold with your usual costs.
The Add spending alert panel with the Engineering team, a monthly period, and a $5,000 threshold
The new alert shows in the list. The bar shows the percentage of the threshold that the subject uses in the current period.
The Engineering team alert at 60% of its monthly threshold
Alerts on a team or API key show in your dashboard notifications. fal emails an alert on one member to the members with the Admin role. Periods reset at 12:00 AM UTC. Alerts count model API usage only.

Set Up a Lock

  1. Click Add lock.
  2. In an organization, select the team.
  3. Select the subject.
  4. Enter an internal note. Members with the Admin or Billing role can see this note.
  5. Select when the lock ends.
  6. Click Lock now.
The Add spending lock panel for the batch-jobs API key, with a note and an end-of-month end date
The page shows each lock that blocks requests.
A lock on the batch-jobs API key that blocks new requests

Remove a Lock

To remove all locks, click Unlock all. To remove one lock, expand its row. Then click Unlock.