Обмеження частоти запитів

Обмеження частоти запитів — це обмеження, які наш API накладає на кількість разів, коли користувач або клієнт може отримати доступ до наших сервісів протягом визначеного періоду часу.

Навіщо потрібні обмеження

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

Щоб наш сервіс залишався безпечним і надійним! Уявляйте обмеження частоти запитів як доброзичливих вишибал — вони стежать, щоб ніхто не перевантажив наш API надмірною кількістю запитів одночасно. Це допомагає захистити наш сервіс від потенційного зловживання та забезпечує безперебійну роботу.
Щоб кожен отримав свою справедливу частку. Так само, як діляться іграшками на дитячому майданчику, ми хочемо переконатися, що всі наші користувачі мають рівний доступ до API. М’яко обмежуючи кількість запитів, які може зробити кожен користувач, ми гарантуємо, що нікому не доведеться надто довго чекати своєї черги.
Щоб продуктивність залишалася швидкою та надійною. Керуючи загальним потоком запитів, ми можемо підтримувати швидкий час відповіді та стабільний сервіс для всіх наших чудових користувачів. Це як стежити, щоб шосе не стало надто переповненим — рух іде краще, коли ми запобігаємо заторам!

Як працюють обмеження

Обмеження частоти запитів вимірюються 2 способами:

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

Завдання в черзі включають endpoints Текст у 3D, Зображення у 3D, Текст у текстуру та Ремеш. Інші endpoints, як-от Upload і Баланс, не входять до цього обмеження.

Обмеження застосовуються для кожного облікового запису окремо. Це означає, що обмеження спільні для всіх ваших 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.