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

Життєвий цикл завдання

Дізнайтеся, як завдання проходить шлях від запиту до результату, скільки часу це зазвичай займає і скільки ваш код має чекати на результат.


Як виконується завдання

Запит на створення повертає ID завдання, не чекаючи на його виконання. Потім завдання виконується у фоновому режимі, і ви можете відстежувати його одним із трьох способів: опитувати його GET кінцеву точку, відкрити його потокову (stream) кінцеву точку або отримати 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 хвилин вказано в секундах (s), а довший — у хвилинах (min). Значення «не підтримується» означає, що API не пропонує цю опцію для цієї моделі.

3D-генерація

APIКонфігураціяmeshy-7.1 (latest)meshy-6meshy-6-litemeshy-t2
Текст у 3D (Preview)Лише сітка75 s90 s45 s10 s
Зображення у 3DЛише сітка75 s90 s40 s4 s
Сітка з 2K текстурами2 min3 min75 s60 s
Сітка з 4K текстурами2.5 min3.5 minНе підтримується80 s
Сітка з 8K текстурами3.5 min4 minНе підтримується2.5 min
Мульти-зображення у 3DЛише сітка65 s2 min30 sНе підтримується
Сітка з 2K текстурами2.5 min3.5 min85 sНе підтримується
Сітка з 4K текстурами3 min4 minНе підтримуєтьсяНе підтримується
Сітка з 8K текстурами3.5 min4.5 minНе підтримуєтьсяНе підтримується

Для Зображення у 3D та Мульти-зображення у 3D «Лише сітка» означає should_texture: false. Ці опції та вхідні дані впливають на час:

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

Текстурування

APIРоздільна здатність текстуриТиповий час
Текст у 3D (Refine)2K або 4K80 s
8K3.5 min
Ретекстурування2K55 s
4K90 s
8K2.5 min

Генерація зображень

APInano-banananano-banana-2nano-banana-proМоделі GPT Image
Текст у зображення20 s15 s25 sвід 20 до 35 s
Зображення у зображення40 s20 s30 sвід 20 до 40 s

Rigging та Анімація

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

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

3D-друк

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

У 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 кінцеву точку.