Ограничения скорости

Ограничения скорости — это ограничения, которые наш API накладывает на количество обращений пользователя или клиента к нашим сервисам в течение заданного периода времени.

Зачем нужны лимиты

Мы ввели ограничения скорости в нашем API, чтобы создать наилучший опыт для всех. Вот почему они важны:

Чтобы наш сервис оставался безопасным и надёжным! Представьте ограничения скорости как дружелюбных охранников — они следят за тем, чтобы никто не мог перегрузить наш API слишком большим количеством запросов одновременно. Это помогает защитить сервис от возможного злоупотребления и поддерживает его бесперебойную работу.
Чтобы у всех была справедливая доля. Как и при совместном использовании игрушек на детской площадке, мы хотим обеспечить всем пользователям равный доступ к API. Мягко ограничивая количество запросов, которые может сделать каждый пользователь, мы гарантируем, что никому не придётся долго ждать своей очереди.
Чтобы производительность оставалась быстрой и надёжной. Управляя общим потоком запросов, мы можем поддерживать высокую скорость отклика и стабильную работу сервиса для всех наших замечательных пользователей. Это как следить за тем, чтобы шоссе не было переполнено — движение идёт лучше, когда мы предотвращаем заторы!

Как работают лимиты

Ограничения скорости измеряются двумя способами:

запросов в секунду: количество сетевых запросов, которые вы можете сделать за секунду.
задачи в очереди: количество одновременных задач генерации, которые вы можете выполнять в очереди в любой момент времени.

Задачи в очереди включают эндпоинты Текст в 3D, Изображение в 3D, Текст в текстуру и Ремешинг. Другие эндпоинты, такие как Upload и Balance, в этот лимит не входят.

Лимиты применяются в расчёте на каждый аккаунт. Это означает, что лимиты являются общими для всех ваших API key.

Помимо ограничений скорости, на скорость выполнения ваших задач также влияет приоритет обработки задач.

Каждый уровень пользователя имеет определённые ограничения скорости и уровни приоритета, разработанные с учётом его потребностей. Вот текущие лимиты по уровням:

Уровень пользователя	Запросов в секунду	Задачи в очереди	Уровень приоритета
Pro	20	10	По умолчанию
Premium	20	30	Выше, чем Pro
Ultra	20	100	Наивысший
Studio	20	20	Выше, чем Pro
Enterprise	100	По умолчанию 100, можно настроить	Наивысший

Если вы превысите эти лимиты, вы получите от нашего API ответ 429 Too Many Requests. Есть два типа превышений, которые могут вызвать это, каждый с разным ответом:

Превышение по запросам: это происходит, когда вы делаете слишком много запросов в секунду. Вы получите ответ 429 Too Many Requests с сообщением RateLimitExceeded.
Превышение по очереди: это происходит, когда у вас запущено слишком много одновременных задач генерации. Вы получите ответ 429 Too Many Requests с сообщением NoMoreConcurrentTasks.