Лимиты частоты запросов

Лимиты частоты запросов — это ограничения, которые наш API накладывает на количество раз, которое пользователь или клиент может получить доступ к нашим сервисам в течение заданного периода времени.

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

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

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

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

Лимиты частоты запросов измеряются 2 способами:

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

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

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

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

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

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

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

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