Usage Tiers and Limits
In order to protect our API against abuse and to ensure fair access to our models, we have limits in place that govern how many generations you can create.
Limits
Each organization in the API is subject to a set of limits. These limits are per-organization, not per-API key.
Concurrency limit
This is the maximum number of tasks you can run concurrently in the API. If you submit
more tasks than this limit, your tasks will have a status of "THROTTLED", indicating
that the task is stored on our servers but has not been enqueued for processing. Throttled
tasks will be enqueued in approximately the order that they were submitted in.
Concurrency limit example
To help you reason about how these limits work, here’s an example using some approximations.
Assume you want to generate 200 videos and you have a concurrency limit of 2:
- You can submit all 200 video request tasks at the same time.
- Runway handles the queueing logic and starts executing them in rapid fashion 2-at-a-time, in sequential order based on creation time.
- The first 2 videos finish in 15 seconds and the 3rd and 4th videos begin generating. They finish in 15 additional seconds.
- All 200 videos are complete within 25 minutes (15 seconds x 200 videos / 2 concurrency).
There is no maximum requests-per-minute limit, as long as your requests are within your maximum daily generations limit.
Maximum daily generations
This is the maximum number of generations you can create in a 24-hour window. If you
exceed this limit, you’ll receive a 429 Too Many Requests response to the task creation request,
indicating you’ve exceeded your quota.
Maximum monthly spend
This is the amount of money your organization is allowed to spend on credits in a 30-day window. You will be prevented from purchasing more than this amount, and autobilling will cap any automatic recharges at your remaining monthly spend.
Tiers
Each organization has a usage tier. The tier sets the limits of your organization.
| Tier | Max concurrency | Max gens/day | Max spend/mo. | Criteria to reach tier |
|---|---|---|---|---|
| 1 | 1 | 50 | $100 | |
| 2 | 2 | 200 | $500 | 1 day after $50 purchased |
| 3 | 3 | 500 | $1,000 | 7 days after $100 purchased |
| 4 | 4 | 1,000 | $5,000 | 14 days after $1,000 purchased |
| 5 | 8 | 5,000 | $20,000 | 7 days after $5,000 purchased |
For custom tier information and higher limits, file an exception request from the usage page when logged in to the developer portal.