Limits
A project’s plan limits, its own monthly limit, and the AI units it has used this month.
Read limits
/v1/projects/{project}/limitsNeeds View usage and limits.
{
"plan": {
"code": "free",
"name": "Free",
"unitsPerMonth": 100000,
"requestsPerMinute": 20,
"tokensPerMinute": 40000
},
"own": {
"unitsPerMonth": 50000,
"updatedBy": "01m3c081d2wj4g63qcr53pa1yh",
"updatedAt": "2026-09-29T10:15:00Z"
},
"month": { "start": "2026-09-01", "used": 4200, "reserved": 120 },
"minute": { "start": "2026-09-29T10:15:00Z", "requests": 3, "tokens": 12500 }
}plan.unitsPerMonthintegerThe most AI units the plan allows in a month. In every plan limit, 0 means no limit.
plan.requestsPerMinuteintegerThe most calls the project can send in a minute.
plan.tokensPerMinuteintegerThe most tokens the project’s calls can ask for in a minute: each call’s input, and its
max_tokensof output.ownobject or nullThe project’s own limit, or
nullif it never had one. The lower of it and the plan’s applies.own.unitsPerMonthisnullwhen it was removed, and 0 stops AI for the project.month.startstringThe first day of this month, in UTC.
month.usedintegerThe AI units calls used this month.
minute.requestsintegerThe calls counted so far in this minute, which started at
minute.start.minute.tokensintegerThe tokens those calls asked for: their input, and their
max_tokensof output.month.reservedintegerUnits set aside for calls in progress. See How a call is checked.
Set the project’s own limit
/v1/projects/{project}/limitsOnly a person with Developer access or more can do this, from the console. API keys cannot.
{ "unitsPerMonth": 50000 }unitsPerMonthinteger or nullThe AI units the project may use each month, from 0 to 1,000,000,000,000.
nulluses the plan’s limit again.
The answer is the project’s limits, as above.
Last updated