Docs/Billing
Holds and settlement
Why is my available balance lower than my balance, and when does it come back?
Checked against the code on
Every request reserves the most it could cost before it runs, then settles to what it actually cost when it finishes. The gap between balance and available is those reservations.
- ReserveFor a chat turn: estimated input tokens at the input rate plus the output ceiling at the output rate, or the image floor for a picture model. For a clip: the exact published price.
- RunIf the reservation cannot be made, the request stops with
402and nothing runs. - SettleThe reservation becomes the real charge, using the gateway's own cost figure for the call. If the real cost is somehow above the reservation, the charge is clamped to what you have.
How long a hold lasts
- Workspace chat
- Up to 2 minutes
- API chat completions
- Up to 5 minutes
- Video
- Up to 20 minutes
A request that finishes settles immediately. A request that dies without settling is swept within a minute of its hold expiring, and the credits return to available. You never lose credits to a hold.
Reading it in the wallet
Balance is the ledger. Available is balance minus open holds. If they differ and nothing is running, wait a minute and refresh.