Limits, and how to raise them
How many requests and jobs you can have at once. A request over a limit is refused with a Retry-After, never queued, never charged.
Request and job limits
Section titled “Request and job limits”Requests per minute, in fixed 60-second windows. Each is counted for the key and for every key on the same paying account together.
| Class | What counts | Per key | Per account |
|---|---|---|---|
start | A paid start (make_video, make_image, edit_image, recast, make_music, creator_video, run_template) | 10 | 30 |
quote | A dry_run call, and GET /models with a key | 60 | 180 |
read | GET /results, GET /results/{id}, GET /templates, the callback log | 120 | 360 |
upload | POST /uploads | 30 | 60 |
write | Drafting an ads launch | 20 | 40 |
- Jobs at once: up to 8 jobs queued or running per paying account. A key can carry a lower limit of its own. Test-key runs do not count.
- Test keys: up to 200 test runs per person per 24 hours (
TEST_LIMIT).
Over a request limit the answer is 429 RATE_LIMITED with Retry-After (seconds to the end of the window). A refused request still counts, so waiting works better than hammering. Over the jobs limit the answer is 429 CONCURRENCY_LIMIT with Retry-After: 15. Work you already started keeps running.
If our own capacity is full the answer is 503 PROVIDER_BUSY. That is not your fault and nothing is charged; retry after Retry-After.
Money limits
Section titled “Money limits”You can cap spend per key and per account, per day and per month, on the Developers page. Over a cap the answer is 402 BUDGET_EXCEEDED with budget.resets_at. It never triggers an automatic top-up.
At most 25 active keys per person, and 20 new keys an hour (KEY_LIMIT). Too many bad keys from one address in a minute answers AUTH_RATE_LIMITED.
How to read your limits in code
Section titled “How to read your limits in code”Poll politely: every 15 to 30 seconds for a job, or use a callback. Dry runs have their own, larger limit (quote), so check prices as often as you need.
Asking for more
Section titled “Asking for more”If you need higher limits, book a call or write to hello@diffusr.ai. Say your use, how many jobs at once, and how many requests a minute.