Обмеження частоти

Перевірте, скільки запитів і задач дозволяє ваш план, і що робити, коли ви досягаєте ліміту.

Ліміти за планом

Щоб API залишався швидким і доступним для всіх, Meshy обмежує кожен обліковий запис двома способами:

Запитів на секунду: скільки API-запитів ви можете надсилати щосекунди.
Паралельні задачі: скільки ваших задач можуть одночасно мати статус PENDING або IN_PROGRESS.

Ліміти залежать від вашого плану:

План	Запитів на секунду	Паралельні задачі	Пріоритет
Pro	20	10	За замовчуванням
Premium	20	30	Вищий, ніж у Pro
Ultra	20	100	Найвищий
Studio	20	60, або 20 у деяких попередніх планах Studio	Вищий, ніж у Pro
Enterprise	100	100 за замовчуванням, або індивідуальний ліміт	Найвищий

Пріоритет — це не ліміт. Коли черга завантажена, Meshy першими запускає задачі з вищим пріоритетом.

Що враховується в кожному ліміті

Кожен API-запит враховується в обмеженні запитів на секунду, включно із запитами, що отримують, перелічують або транслюють задачі. Запити з веб-застосунку Meshy не враховуються.

Ліміт паралельних задач рахує задачі, а не запити. Кожна кінцева точка, яка створює задачу, перевіряє цей ліміт перед її створенням. Наприклад, його перевіряють Текст у 3D, Зображення у 3D, Мульти-зображення у 3D, Ретекстурування, Ремеш, Rigging, Анімація, Текст у зображення, кінцеві точки 3D-друку та Creative Lab.

Запити, які не створюють задачу, не враховуються в цьому ліміті. Наприклад, Balance, Usage та запити, що отримують, перелічують або транслюють задачі, не враховуються.

Чиї ліміти застосовуються

Наступна таблиця показує, чиї ліміти враховують ваші API-ключі, Playground і веб-застосунок:

Де ви працюєте	Особистий обліковий запис	Команда
API-ключі	Ваші ліміти	Ліміти команди, спільні для кожного API-ключа в команді
Playground	Ваші ліміти	Ваші власні ліміти як учасника, що увійшов у систему
Веб-застосунок	Ваші паралельні задачі	Ваші власні паралельні задачі. Задачі, які запускає власник команди, також враховуються в лімітах команди.

Коли ви досягаєте ліміту

Коли ви перевищуєте ліміт, API повертає 429 Too Many Requests. Повідомлення вказує, якого ліміту ви досягли:

Забагато запитів на секунду: повідомлення — Rate limit exceeded. Зачекайте кількість секунд, вказану в заголовку Retry-After, потім повторіть спробу.
Забагато паралельних задач: повідомлення починається з NoMorePendingTasks. На необмеженому плані без залишку кредитів воно починається з NoMoreConcurrentTasks. Ця помилка 429 не має заголовка Retry-After. Зачекайте, поки одна з ваших задач завершиться, а потім створіть наступну.

Заголовки обмеження частоти

Відповіді API містять такі заголовки, щоб допомогти вам розподіляти запити:

Заголовок	Опис
`X-RateLimit-Limit`	Кількість запитів, дозволених за секунду на вашому плані.
`X-RateLimit-Remaining`	Кількість запитів, що залишилися в поточній секунді.
`X-RateLimit-Reset`	Секунд до повного відновлення вашого бюджету.
`Retry-After`	Кількість секунд очікування перед наступним запитом. Надсилається з `429` при перевищенні ліміту запитів на секунду, а також коли ви отримуєте задачу, яка все ще має статус `PENDING` або `IN_PROGRESS`.

Коли присутній заголовок Retry-After, зачекайте вказану кількість секунд перед надсиланням наступного запиту.