Limits
How much, how fast, and what happens past it.
Levels
Your account has a level. See yours with GET /v1/account.
| Level | New generations a minute | In progress at once | Credits a day |
|---|---|---|---|
| Sandbox (test keys) | 30 | 5 | Free |
| Start | 10 | 2 | 2,500 |
| Build | 60 | 5 | 10,000 |
| Scale | 300 | 20 | 100,000 |
| Custom | 600 | 50 | 1,000,000 |
Other limits
| What | Limit |
|---|---|
| All calls with one key | 600 a minute |
| Uploads with one key | 60 a minute |
| The open catalog, per address | 60 a minute |
| Request body | 1 MB. Files go through Uploads |
Prefer: wait | 60 seconds |
| A prompt | 10,000 characters |
The day runs on UTC and resets at 00:00. A key can have its own spend limit on top: see Authentication.
Past a limit
| Code | What to do |
|---|---|
rate_limited | Wait for Retry-After, then send the same request |
too_many_active | Wait for one to finish |
spend_limit_reached | Wait for the reset, or raise the limit |
How long things stay
| What | How long |
|---|---|
| Results | 7 days. Links stop at expires_at, and retention_hours can make it shorter |
| Uploaded files | 48 hours |
Download what you want to keep. Result links are public but impossible to guess: anyone with the link can open it, so treat it like a secret if it matters.