Ліміти швидкості
Ліміти швидкості — це обмеження, які наш API накладає на кількість разів, коли користувач або клієнт може звертатися до наших сервісів протягом визначеного періоду часу.
Чому потрібні ліміти
Ми впровадили ліміти швидкості в нашому API, щоб створити найкращий досвід для всіх. Ось чому вони важливі:
-
Щоб зберегти наш сервіс безпечним і надійним! Уявіть ліміти швидкості як дружніх охоронців — вони гарантують, що ніхто не зможе перевантажити наш API занадто великою кількістю запитів одночасно. Це допомагає захистити наш сервіс від потенційного зловживання та забезпечує його безперебійну роботу.
-
Щоб гарантувати, що кожен отримує свою справедливу частку. Так само, як діти діляться іграшками на майданчику, ми хочемо забезпечити всім нашим користувачам рівний доступ до API. Обережно обмежуючи кількість запитів, які може зробити кожен користувач, ми гарантуємо, що нікому не доведеться занадто довго чекати своєї черги.
-
Щоб продуктивність залишалася швидкою та надійною. Керуючи загальним потоком запитів, ми можемо підтримувати швидкий час відповіді та стабільний сервіс для всіх наших чудових користувачів. Це як забезпечення того, щоб автомагістраль не була занадто перевантаженою — трафік рухається краще, коли ми запобігаємо заторам!
Як працюють ліміти
Ліміти швидкості вимірюються двома способами:
- Запитів на секунду: це кількість мережевих запитів, які ви можете зробити за секунду.
- Завдання в черзі: це кількість одночасних завдань генерації, які ви можете виконувати в черзі в будь-який момент часу.
Завдання в черзі включають endpoint'и Текст у 3D, Зображення у 3D, Текст у текстуру та Ремеш. Інші endpoint'и, такі як Upload та Balance, не входять до цього ліміту.
Ліміти застосовуються на рівні облікового запису. Це означає, що ліміти є спільними для всіх ваших API keys.
Окрім лімітів швидкості, на швидкість виконання ваших завдань також впливає пріоритет обробки завдань.
Кожен рівень користувача має специфічні ліміти швидкості та рівні пріоритету, розроблені відповідно до їхніх потреб. Ось поточні ліміти за рівнями:
| Рівень користувача | Запитів на секунду | Завдання в черзі | Рівень пріоритету |
|---|---|---|---|
| Pro | 20 | 10 | За замовчуванням |
| Premium | 20 | 30 | Вищий, ніж у Pro |
| Ultra | 20 | 100 | Найвищий |
| Studio | 20 | 20 | Вищий, ніж у Pro |
| Enterprise | 100 | За замовчуванням 100, можна налаштувати | Найвищий |
Якщо ви перевищите ці ліміти, ви отримаєте відповідь 429 Too Many Requests від нашого API. Є два типи спрацьовувань, які можуть це викликати, кожен з різною відповіддю:
- Request Hit: це трапляється, коли ви робите занадто багато запитів за секунду. Ви отримаєте відповідь
429 Too Many Requestsз повідомленнямRateLimitExceeded. - Queue Hit: це трапляється, коли у вас запущено занадто багато одночасних завдань генерації. Ви отримаєте відповідь
429 Too Many Requestsз повідомленнямNoMoreConcurrentTasks.