Жизненный цикл задачи

Узнайте, как задача проходит путь от запроса до результата, сколько времени это обычно занимает и как долго ваш код должен ждать результата.

Как выполняется задача

Запрос на создание возвращает ID задачи, не дожидаясь её выполнения. Затем задача выполняется в фоновом режиме, и отслеживать её можно одним из трёх способов: опрашивать её GET-эндпоинт, открыть её потоковый эндпоинт или получить webhook.

Задача фиксирует каждый шаг в полях created_at, started_at и finished_at.

В следующей таблице показано, что должен делать ваш код при каждом статусе.

SUCCEEDED, FAILED и CANCELED являются финальными. После того как задача достигает одного из этих статусов, он больше никогда не меняется.

Со стороны вашего кода это выглядит так:

Время обработки

В следующих таблицах показаны медианные значения времени на продуктивном трафике API за сентябрь 2026 года.

Время отсчитывается от создания задачи до финального статуса. Почти всё это время уходит на обработку, поскольку задача обычно находится в статусе PENDING лишь несколько секунд. Когда очередь загружена, задачи могут дольше ждать начала выполнения, а задачи на планах с более высоким приоритетом обычно начинают выполняться раньше.

Время менее 2 минут указано в секундах (с), а более долгое — в минутах (мин). Значение «не поддерживается» означает, что API не предлагает эту опцию для данной модели.

Генерация 3D

Для Изображение в 3D и Мульти-изображение в 3D «Только сетка» означает should_texture: false. Следующие опции и входные данные влияют на время:

• PBR-карты (enable_pbr) добавляют от 30 до 60 секунд.
• Ultra-геометрия (geometry_resolution: "2k" или "4k") добавляет до 1 минуты.
• При одинаковых настройках более сложные входные изображения требуют больше времени.

Текстурирование

Генерация изображений

Rigging и Анимация

Пост-обработка

3D-печать

В v2 Восстановление пригодности к печати и Анализ пригодности к печати всегда выполняют проверку тонких стенок. В v1 эта проверка выполняется, когда вы указываете тип принтера или размер печати.

Сколько времени ждать

Задача продолжает выполняться, даже если ваш код прекращает ожидание. Если истекает timeout вашего запроса, обрывается соединение или закрывается поток, задача не завершается с ошибкой и не отменяется.

• Ждите не менее 60 минут, отсчитывая от created_at задачи, прежде чем прекратить ожидание. Если вы остановитесь раньше, вы можете пропустить задачу, которая завершится успешно позже. Это происходит в основном в периоды высокой нагрузки.
• Сохраняйте ID задачи. Вы можете запросить задачу повторно в любое время. Если она всё ещё не достигла финального статуса спустя 60 минут, проверьте её снова позже. Если ситуация не меняется, обратитесь в службу поддержки.
• Только статус FAILED означает, что задача завершилась с ошибкой. Meshy автоматически возвращает кредиты за неудачные задачи.

Используйте в коде следующие значения:

Для большого числа задач одновременно используйте webhooks вместо опроса каждой из них. Если финальное событие задачи не поступило спустя примерно удвоенное типичное время, запросите задачу через её GET-эндпоинт.