Если ваша интеграция получает ошибки 429, RateLimitExceeded или NoMoreConcurrentTasks при вызове Meshy API, это руководство объясняет, почему существуют эти ограничения и как спроектировать интеграцию так, чтобы работать в их рамках.
Почему существуют ограничения скорости
API Meshy работает поверх общих GPU-ресурсов, используемых для генерации 3D-моделей, текстур и связанных ассетов. Ограничения скорости и лимиты параллелизма защищают эту общую инфраструктуру, чтобы качество генерации и время обработки оставались стабильными для каждого пользователя платформы. У каждого аккаунта в зависимости от текущего плана есть максимальное количество запросов, которые он может сделать за заданный временной интервал, и максимальное количество задач генерации, которые могут выполняться одновременно (в очереди или в процессе).
Ограничение запросов vs. ограничение очереди/параллелизма
Существуют два разных ограничения, и они проявляются по-разному:
Ограничение частоты запросов (429 / RateLimitExceeded): оно ограничивает количество вызовов API (например, создание задач, опрос статуса), которые вы можете выполнить в минуту. При его превышении это означает, что вы вызываете API слишком часто, независимо от того, сколько задач фактически выполняется.
Ограничение параллелизма / очереди (NoMoreConcurrentTasks): оно ограничивает количество задач генерации, которые вы можете одновременно держать в очереди или в обработке. При его превышении это означает, что у вас уже максимальное количество активных задач, и нужно дождаться завершения одной из них, прежде чем отправлять следующую.
Проверьте текущие ограничения запросов и параллелизма вашего плана в панели управления Meshy, поскольку они могут различаться в зависимости от уровня плана.
Стратегия повтора для ошибок 429
Получив ответ 429 или RateLimitExceeded, не повторяйте тот же запрос сразу. Вместо этого:
Используйте экспоненциальную задержку (exponential backoff): подождите короткий интервал, а при каждой последующей неудаче удваивайте его до разумного максимума.
Добавьте джиттер (небольшое случайное смещение) к интервалу задержки, чтобы несколько воркеров в вашей системе не повторяли запрос одновременно.
Соблюдайте заголовки Retry-After или заголовки ограничения скорости, возвращённые в ответе, если они присутствуют, вместо того чтобы угадывать время ожидания.
Ограничьте число повторов на запрос, чтобы постоянная ошибка не приводила к бесконечному циклу.
Планирование с учётом ограничений параллелизма
Ошибка NoMoreConcurrentTasks означает, что вы уже достигли предельного числа активных задач для своего аккаунта. Чтобы не сталкиваться с ней в рабочей среде:
Поддерживайте локальную очередь или планировщик заданий в своём приложении, который отправляет новую задачу генерации только после завершения предыдущей или когда число ваших активных задач опускается ниже лимита.
Опрашивайте статус задач (или используйте вебхуки, если они поддерживаются в вашем сценарии работы), чтобы узнавать, когда освобождается слот, а не отправляйте запросы наугад.
Объединяйте пакетные задания генерации в группы и ограничивайте их интенсивность, вместо того чтобы отправлять все запросы сразу — это сглаживает как частоту запросов, так и число параллельных задач.
Настройте на своей стороне мониторинг и оповещения, чтобы всплеск ошибок 429/NoMoreConcurrentTasks был заметен до того, как он повлияет на ваших пользователей.
Повтор неудачных или неудовлетворительных генераций
Meshy API в настоящее время не поддерживает встроенный «повтор» существующей генерации для индивидуальных планов или планов Studio — если результат не соответствует вашим ожиданиям, вы отправляете новый запрос на генерацию, который расходует кредиты как обычно. Когда ваш автоматизированный конвейер обрабатывает временные ошибки (например, 429), убедитесь, что логика повтора только повторно отправляет исходный запрос после задержки, а не создаёт каждый раз дублирующиеся задачи генерации.
Когда стоит рассмотреть обновление плана
Если вы уже реализовали стратегию повтора и очередь с учётом параллелизма, но по-прежнему регулярно упираетесь в ограничения скорости или параллелизма, это обычно означает, что потребности вашей интеграции в пропускной способности превысили лимиты текущего плана. Проверьте в панели управления допустимые значения запросов и параллелизма для вашего текущего плана и рассмотрите обновление плана или обратитесь в отдел продаж Meshy, чтобы узнать о доступе к API корпоративного уровня, если вам нужна стабильно более высокая пропускная способность.
FAQ
1. Что означает ошибка 429 или RateLimitExceeded?
Это означает, что вы превысили допустимое для вашего плана количество запросов к API за заданный промежуток времени. Снизьте частоту запросов и используйте экспоненциальную задержку перед повторной попыткой.
2. Что означает NoMoreConcurrentTasks?
Это означает, что у вас уже стоит в очереди или выполняется максимальное для вашего аккаунта количество задач генерации. Дождитесь завершения существующей задачи или уменьшите количество одновременно отправляемых задач, прежде чем отправлять новые.
3. Как узнать ограничения скорости и параллелизма моего аккаунта?
Проверьте ограничения для вашего текущего плана в панели управления Meshy — они могут различаться в зависимости от уровня плана.
4. Поддерживает ли Meshy автоматические повторы для задач генерации?
Нет, для индивидуальных планов и планов Studio — нет: неудачную или неудовлетворительную генерацию нужно повторно отправить как новый запрос, и кредиты за него списываются обычным образом. Клиентам Enterprise следует обратиться в отдел продаж по поводу функциональности повторов.
5. Как лучше всего избежать этих ошибок в рабочем конвейере?
Реализуйте локальную очередь, которая ограничивает отправку запросов, чтобы не превышать лимит параллелизма; добавьте экспоненциальную задержку со случайным разбросом для любых ответов 429 и отслеживайте частоту ошибок, чтобы реагировать до того, как они повлияют на ваших пользователей.
6. Когда стоит обновить план из-за ограничений скорости?
Если вы уже реализовали задержки и очередь с учётом параллелизма, но по-прежнему регулярно упираетесь в эти лимиты, скорее всего, ваше использование переросло текущий план — проверьте панель управления или свяжитесь с отделом продаж, чтобы обсудить план с более высокой пропускной способностью.