Rules
A rule is one model, one metric, one number, one reset behaviour.Metrics
Grouped by window. Daily and monthly reset, total never does. Tokens. Input, output, cached input, cached output, total, cached total. Available in all three windows. Requests, images, audio seconds. All three windows. Spending. Daily, monthly and total, in euros. Searches. Daily searches and daily deep searches.Rolling and Calendar
Calendar resets at a fixed boundary. A daily rule goes back to zero at 00:00, a monthly rule on the 1st. Rolling counts a moving window ending right now, 24 hours for a daily rule and 30 days for a monthly rule, so old usage falls off gradually instead of all at once. ATOTAL_ rule is cumulative and never resets, so the period does not apply.
Limits
Workspace budget
Separate from the rules above, each workspace carries a monthly spend cap. It defaults to EUR 10.00, and setting it to zero means no cap. The cap is enforced before the request runs, not after. The gateway estimates what the call will cost, reserves that amount against the workspace, and once the response is complete it settles the reservation against what was actually spent. A request that would push the workspace past its cap is refused rather than run and billed.The reservation is an estimate, so a workspace close to its cap can see a
request refused whose real cost would have fit. Raise the budget rather than
retrying.
When a quota is hit
The request is refused with429 and a message naming the rule and its reset
time. Nothing is charged for a refused request.
Raise the limit, disable the rule or wait for the window to reset.