Обмеження швидкості

Обмеження швидкості — це обмеження, які наш 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.