Rate limits and credits
How requests are limited per key and account, how credits are counted, and how auto-recharge works.
Credits
| What | Credits |
|---|---|
| Image | 1 |
| GIF or video | 1 per analysed frame (max_frames, default 5 / 10) |
| Media above 10 MB | +1 per started 10 MB |
| Any error | 0 |
Free accounts get 500 credits on the first day of each month (UTC). Prepaid packs never expire and are used after the free credits. GET /v1/usage and GET /v1/me show the balance; every analyze response carries usage.balance and the X-Credits-Remaining header.
Limits
| Free | Paid | |
|---|---|---|
| Requests per second | 1 (burst 3) | 3 (burst 15), higher on request |
| In flight | 2 | 8 |
| Media size | 8 MB, no video | 32 MB uploads; 64 MB video by URL |
| Bandwidth per day | 200 MB | 20 GB |
Rate limits answer 429 with Retry-After and the RateLimit / RateLimit-Policy headers. When all model replicas are busy you get 503 overloaded and paying traffic is served first; wait the suggested seconds and retry.
Auto-recharge
In the console you can save a card and set a threshold: when the balance drops below it, the chosen pack is bought automatically (at most three times a day) through a Stripe invoice, so tax is applied correctly and you receive an invoice. After three failed charges auto-recharge switches itself off and you get an email.