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

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

Почему ограничения

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

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

Как работают ограничения

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

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

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

Ограничения применяются на основе учетной записи. Это означает, что ограничения распространяются на все ваши API keys.

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

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

Уровень пользователя	запросов в секунду	задачи в очереди	Уровень приоритета
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.