Лимиты запросов
Сколько запросов можно отправлять, что будет, если отправить больше, и какие ещё ограничения стоит знать.
Лимиты защищают всех, кто пользуется сервисом. Значения по умолчанию с запасом покрывают обычную работу; если вы всё же упрётесь в лимит, ответ точно скажет, сколько подождать.
Коротко
| Лимит | По умолчанию | Что будет при превышении |
|---|---|---|
Запросы на запись от аккаунта (createTask, retry, загрузки …) | 1000 за 10 секунд | 429 с Retry-After |
Запросы на чтение от аккаунта (recordInfo, models, jobs, quote …) | 1000 за 10 секунд | 429 с Retry-After |
| Тикеты загрузки | 1000 за 10 секунд, сверх запросов на запись | 429 с Retry-After |
Отчёт о расходах (/api/v1/usage) | 30 в минуту на аккаунт | 429 с Retry-After |
| Библиотека ассетов | 60 чтений и 30 сохранений в минуту плюс дневной лимит новых ассетов | 429 с Retry-After |
| Любой запрос до проверки ключа | 6000 в минуту на сеть | 429 |
| Тело запроса | 2 МиБ JSON | 413 |
| Баланс | Сколько есть на аккаунте | 40201 |
| Лимиты расходов ключа | Нет, пока вы их не зададите | 40202 |
Лимиты считаются по аккаунту, а не по ключу — новые ключи их не увеличивают.
Заголовки ответа
| Заголовок | Значение |
|---|---|
X-RateLimit-Limit | Ваш лимит в текущем окне |
X-RateLimit-Remaining | Сколько осталось; приходит и в успешных ответах, чтобы можно было притормозить заранее |
Retry-After | В ответе 429: сколько секунд подождать перед повтором |
Цифры выше — значения по умолчанию и могут меняться; ориентируйтесь на заголовки, а не зашивайте их в код.
Как выглядит срабатывание лимита
{ "code": 429, "msg": "Too many requests. Retry in a moment", "request_id": "req_…" }Запрос сверх лимита отклоняется сразу — в очередь он не ставится — и ничего не стоит.
Что делать
- Подождите не меньше
Retry-Afterсекунд и повторите. Добавьте немного случайной задержки, чтобы группа клиентов не вернулась одновременно. - Повторяя
createTask, отправляйте тот жеIdempotency-Key(Идемпотентность). - Опрашивайте неспешно: раз в несколько секунд для изображений, раз в 10–15 секунд для видео. А лучше используйте вебхуки — они вообще не тратят запросы.
Много задач одновременно
Лимиты ограничивают скорость отправки запросов, а не число одновременно выполняющихся задач. Задач в работе может быть много; длинные видео просто идут дольше. Если нужно запустить тысячи задач, растяните отправку во времени и получайте результаты вебхуками.
Нужен лимит повыше для запуска или большой партии? Напишите нам и укажите ожидаемый объём.