Якщо ваша інтеграція отримує помилки 429, RateLimitExceeded або NoMoreConcurrentTasks під час виклику Meshy API, цей посібник пояснює, чому існують ці обмеження та як спроєктувати інтеграцію, щоб працювати в їхніх межах.
Чому існують обмеження швидкості
Meshy API розміщено перед спільними GPU-обчисленнями, які використовуються для генерації 3D-моделей, текстур і пов'язаних активів. Обмеження швидкості та паралелізму захищають цю спільну інфраструктуру, щоб якість генерації та час обробки залишалися стабільними для кожного користувача платформи. Кожен акаунт залежно від поточного тарифу має максимальну кількість запитів, які можна зробити за певний проміжок часу, і максимальну кількість завдань генерації, які можуть виконуватися (у черзі або в процесі) одночасно.
Обмеження запитів vs. обмеження черги/паралелізму
Існують два різні обмеження, і вони проявляються по-різному:
Обмеження частоти запитів (429 / RateLimitExceeded): це ліміт на кількість викликів API (наприклад, створення завдання, перевірка статусу), які ви можете зробити за хвилину. Його перевищення означає, що ви викликаєте API занадто часто, незалежно від того, скільки завдань насправді виконується.
Обмеження паралелізму / черги (NoMoreConcurrentTasks): це ліміт на кількість завдань генерації, які ви можете мати в черзі або в обробці одночасно. Його перевищення означає, що у вас уже досягнуто максимальної кількості активних завдань, і потрібно дочекатися завершення одного з них, перш ніж надсилати наступне.
Перевірте поточні обмеження частоти запитів і паралелізму вашого тарифу в панелі керування Meshy, оскільки вони можуть відрізнятися залежно від рівня тарифу.
Стратегія відступу для помилок 429
Коли ви отримуєте відповідь 429 або RateLimitExceeded, не повторюйте той самий запит одразу. Натомість:
Використовуйте експоненційний відступ: зачекайте короткий інтервал, а потім подвоюйте його з кожною наступною невдачею до розумного максимуму.
Додайте джиттер (невелике випадкове відхилення) до інтервалу відступу, щоб кілька воркерів у вашій системі не повторювали спробу одночасно.
Дотримуйтесь будь-яких заголовків Retry-After або заголовків обмеження швидкості, повернутих у відповіді, якщо вони є, замість того, щоб вгадувати час очікування.
Обмежте кількість повторних спроб на запит, щоб постійна помилка не повторювалася нескінченно.
Планування з урахуванням обмежень паралелізму
Помилка NoMoreConcurrentTasks означає, що ви вже досягли граничної кількості активних завдань для свого акаунта. Щоб не натрапляти на неї в продакшні:
Підтримуйте локальну чергу або планувальник завдань у своєму застосунку, який надсилає нове завдання генерації лише після завершення попереднього або коли кількість ваших активних завдань стане нижчою за ліміт.
Опитуйте статус завдання (або використовуйте вебхуки, якщо це підтримується у вашому робочому процесі), щоб дізнатися, коли звільниться слот, замість того щоб надсилати запити навмання.
Об'єднуйте в пакети та обмежуйте масові завдання генерації, а не надсилайте всі запити одразу — це згладжує як частоту запитів, так і кількість одночасних завдань.
Налаштуйте моніторинг і сповіщення на своєму боці, щоб різке зростання помилок 429/NoMoreConcurrentTasks було помітним до того, як воно вплине на ваших користувачів.
Повторні спроби невдалих або незадовільних генерацій
Meshy API наразі не підтримує вбудований «повтор» наявної генерації для індивідуальних тарифів або тарифів Studio — якщо результат не відповідає вашим очікуванням, ви надсилаєте новий запит на генерацію, який звичайно споживає кредити. Коли ваш автоматизований пайплайн обробляє тимчасові помилки (наприклад, 429), переконайтеся, що ваша логіка повторних спроб лише повторно надсилає початковий запит після відступу, а не створює дублікати завдань генерації щоразу.
Коли варто розглянути оновлення тарифу
Якщо ви вже впровадили відступ і чергу з урахуванням паралелізму, але досі постійно натрапляєте на обмеження швидкості чи паралелізму, це зазвичай означає, що потреби пропускної здатності вашого інтеграційного рішення перевищили ліміти поточного тарифу. Перегляньте у своїй панелі керування дозволені для поточного тарифу кількості запитів і паралельних завдань і розгляньте можливість оновлення тарифу або зверніться до відділу продажів Meshy щодо доступу до API корпоративного рівня, якщо вам потрібна стабільно вища пропускна здатність.
Часті питання
1. Що означає помилка 429 або RateLimitExceeded?
Це означає, що ви перевищили кількість запитів до API, дозволену протягом певного проміжку часу для вашого тарифу. Знизьте частоту запитів і використовуйте експоненційний відступ перед повторною спробою.
2. Що означає NoMoreConcurrentTasks?
Це означає, що ви вже маєте максимальну кількість завдань генерації в черзі або в процесі виконання для вашого акаунта. Зачекайте, доки завершиться наявне завдання, або зменште кількість завдань, які надсилаєте одночасно, перш ніж надсилати нові.
3. Як дізнатися про обмеження мого акаунта?
Перегляньте панель керування Meshy, щоб дізнатися про обмеження, пов'язані з вашим поточним тарифом, оскільки вони можуть відрізнятися між рівнями тарифів.
4. Чи підтримує Meshy автоматичні повторні спроби?
Ні, не для індивідуальних тарифів чи тарифів Studio — невдалу або незадовільну генерацію потрібно надіслати повторно як новий запит, що зазвичай споживає кредити. Клієнтам Enterprise слід звернутися до відділу продажів щодо функціональності повторних спроб.
5. Як найкраще уникнути цих помилок у продакшн-пайплайні?
Реалізуйте локальну чергу, яка обмежує надсилання запитів, щоб не перевищувати ліміт паралелізму, додайте експоненційний відступ із випадковим розкидом для будь-яких відповідей 429 і відстежуйте рівень помилок, щоб реагувати до того, як вони вплинуть на ваших користувачів.
6. Коли варто оновити тариф через обмеження швидкості?
Якщо ви вже впровадили відступ і чергу з урахуванням паралелізму, але все ще регулярно натрапляєте на ці обмеження, ймовірно, ваше використання перевищило можливості поточного тарифу — перегляньте панель керування або зверніться до відділу продажів щодо тарифу з вищою пропускною здатністю.