lowpoly будет отключён 30 окт. 2026 г.. meshy-7 как модель 3D-генерации будет отключена 31 дек. 2026 г.; как модель текстурирования она остаётся доступной. Перейдите на другую модель до этих дат, чтобы избежать ошибок в запросах. Все устаревшие функции

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

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


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

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

Запрос на создание запускает задачу со статусом PENDING. Воркер подхватывает её, и она переходит в статус IN_PROGRESS, в котором проводит большую часть времени. Завершается она статусом SUCCEEDED или FAILED, и финальный статус больше никогда не меняется.
Запрос на создание
PENDING
Ожидание в очереди
IN_PROGRESS
Генерация результата
SUCCEEDED
Скачать результат
FAILED
Кредиты возвращены

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

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

СтатусЧто должен делать ваш код
PENDINGПродолжать ждать.
IN_PROGRESSОтслеживать progress: процент выполненной работы, от 0 до 100.
SUCCEEDEDСкачать результат. Meshy хранит файлы ограниченное время. См. Хранение ресурсов.
FAILEDПрочитать task_error, затем исправить входные данные или создать новую задачу. См. Ошибки.
CANCELEDПрекратить ожидание. Задача не даст результата. Этот статус используется только для задач Creative Lab.

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

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

Создайте задачу, затем опрашивайте её до завершения.
  1. Запрос: POST/image-to-3d

  2. Ответ: 202{ "result": "<task_id>" }задача создана

  3. Повторять каждые несколько секунд
    1. Запрос: GET/image-to-3d/<task_id>

    2. Ответ: 200{ "status": "IN_PROGRESS","progress": 45 }Retry-After: 5

  4. Запрос: GET/image-to-3d/<task_id>

  5. Ответ: 200{ "status": "SUCCEEDED","model_urls": { "glb": "…" } }

Если ваше приложение прекращает ожидание, задача продолжает выполняться. Выполните её GET позже с тем же ID задачи.

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

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

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

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

Генерация 3D

APIКонфигурацияmeshy-7.1 (latest)meshy-6meshy-6-litemeshy-t2
Текст в 3D (предпросмотр)Только сетка75 с90 с45 с10 с
Изображение в 3DТолько сетка75 с90 с40 с4 с
Сетка с текстурами 2K2 мин3 мин75 с60 с
Сетка с текстурами 4K2,5 мин3,5 минНе поддерживается80 с
Сетка с текстурами 8K3,5 мин4 минНе поддерживается2,5 мин
Мульти-изображение в 3DТолько сетка65 с2 мин30 сНе поддерживается
Сетка с текстурами 2K2,5 мин3,5 мин85 сНе поддерживается
Сетка с текстурами 4K3 мин4 минНе поддерживаетсяНе поддерживается
Сетка с текстурами 8K3,5 мин4,5 минНе поддерживаетсяНе поддерживается

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

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

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

APIРазрешение текстурыТипичное время
Текст в 3D (Refine)2K или 4K80 с
8K3,5 мин
Ретекстурирование2K55 с
4K90 с
8K2,5 мин

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

APInano-banananano-banana-2nano-banana-proМодели GPT Image
Текст в изображение20 с15 с25 сот 20 до 35 с
Изображение в изображение40 с20 с30 сот 20 до 40 с

Rigging и Анимация

APIКонфигурацияТипичное время
Auto-RiggingАвтоматический rigging40 с
АнимацияЗа запрос15 с
Текст в движениеmode prime15 с
mode swift10 с

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

3D-печать

APIКонфигурацияТипичное время
Анализ пригодности к печатиТолько проверка сетки1 с
Проверка сетки и тонких стенок10 с
Multi-ColorЗа запрос30 с
Восстановление пригодности к печатиТолько восстановление сетки10 с
Проверка тонких стенок, стенки сохранены20 с
Проверка тонких стенок, стенки утолщены100 с
Auto SplitЧасти сплошного цвета70 с
Текстурированные части (keep_texture: true)170 с

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


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

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

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

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

НастройкаРекомендуемое значение
Timeout запроса на создание (POST)60 секунд
Timeout запроса на создание (POST) с файлом model_url размером более 100 МБ120 секунд. Meshy скачивает файл, прежде чем ответить.
Timeout запроса статуса (GET)30 секунд
Интервал опросаЗначение заголовка Retry-After, либо 5 секунд, если он отсутствует. Опросы учитываются в вашем ограничении частоты.
Неудачный запрос статуса (timeout, 429 или 5xx)Повторите попытку при следующем опросе. Это не означает, что задача завершилась с ошибкой.
Общее время ожидания на задачуНе менее 60 минут от created_at. Не сбрасывайте этот отсчёт при переподключении потока.
ПотокПоток может закрыться до завершения задачи. Если он закрылся без финального статуса, переподключитесь или перейдите на опрос.

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