Auto Split API

ID завдання, модель якого потрібно розрізати. Завдання повинно мати статус SUCCEEDED. Підтримуються такі типи завдань:

• Зображення у 3D
• Мульти-зображення у 3D
• Текст у 3D, завдання preview або refine
• Ретекстурування
• Ремеш
• Конвертувати
• Змінити розмір

Модель повинна бути створена за допомогою Meshy 6 або Meshy 7, тобто з ai_model, встановленим на meshy-6-lite, meshy-6, meshy-7, meshy-7.1 або latest. Моделі Smart Topology (meshy-t2 та meshy-t2.5) не підтримуються. Для завдань refine, Ретекстурування, Ремеш, Конвертувати або Змінити розмір правило застосовується до моделі, з якої завдання було розпочато. Завдання Ретекстурування, Ремеш, Конвертувати або Змінити розмір, створене з завантаженої моделі, повертає 400.

Модель може мати щонайбільше 8 000 000 полігонів (faces). Модель з більшою кількістю полігонів повертає 400. У такому разі спочатку виконайте для неї завдання Ремеш і надішліть замість цього ID завдання Ремеш.

Ви можете розрізати текстуровану модель. Щоб зберегти текстуру на частинах, надішліть keep_texture: true.

Як розділити модель на частини.

Доступні значення:

• auto: Meshy сама обирає розрізи та ігнорує prompt. prompt довжиною понад 600 символів усе одно поверне 400.
• by_parts: Meshy розрізає за структурними частинами, які ви вказали у prompt, наприклад, голова, руки та тулуб.
• by_color: Meshy розрізає за кольоровими областями, які ви вказали у prompt. Meshy знаходить області у вихідному зображенні, а не в текстурі вхідної моделі. Вхідні дані повинні бути створені із завантаженого зображення за допомогою Зображення у 3D або Мульти-зображення у 3D. Інші типи вхідних даних повертають 400. Для Мульти-зображення у 3D Meshy використовує перше вихідне зображення.

Формати файлів для генерації. Meshy завжди генерує glb і повертає його у model_urls, а також інші формати, вказані вами у списку.

Доступні значення:

• glb
• obj
• fbx
• stl
• usdz
• blend
• 3mf

Усі формати, крім stl, підтримують об'єкти сцени та зберігають кожну частину як окремий об'єкт. Файл STL не може зберігати окремі об'єкти, тому Meshy зливає частини в одне суцільне тіло, розташоване за layout. Щоб отримати частини, які можна вибирати окремо у слайсері, запитуйте 3mf.

З keep_texture: true ці формати зберігають текстуру:

• glb, fbx, usdz та blend: текстура знаходиться у файлі.
• obj: текстура знаходиться у файлі матеріалу, який model_urls повертає під mtl.
• stl та 3mf: файл зберігає лише геометрію, без текстури.

Як Meshy розташовує частини, у кожному форматі файлу та у мініатюрі.

Доступні значення:

• assembled: Meshy залишає частини там, де вони були у вихідній моделі.
• on_plate: Meshy розкладає частини плоско та розподіляє їх на платформі друку, готовими до нарізки (slicing). Це те саме розташування, що й у вигляді On Plate у веб-застосунку.

В обох варіантах розташування Meshy перед експортом видаляє будь-який сплощений або точкоподібний фрагмент, що залишається після розрізу, тож кожна отримана вами частина придатна для друку. Формати, що підтримують об'єкти сцени, зберігають один об'єкт на частину, а stl зливає частини в одне суцільне тіло.

Чи зберігати текстуру вхідної моделі на частинах. true дає кожній частині текстуру вхідних даних, і завдання повертає карти у texture_urls. false дає кожній частині суцільний колір вершин.

З true завдання виконується приблизно вдвічі довше, а вартість у кредитах не змінюється. Нетекстурована вхідна модель розрізається так само, як і з false. Якщо Meshy не може зберегти текстуру, завдання завершується з помилкою з кодом textured_split_refused. Див. Помилки.

Чи додавати з'єднувачі типу шип-паз на кожному розрізі, щоб надруковані частини збиралися разом.

Запит не може бути виконаний. Повідомлення про помилку вказує, яку проблему знайдено. Наприклад:

• Відсутній prompt: mode має значення by_parts або by_color, а prompt відсутній.
• Prompt не описує розділення, або занадто багато частин: prompt просить залишити модель цілою, або називає більше 10 частин. by_parts та by_color приймають від 1 до 10 названих частин. Meshy не стягує плату за цей запит.
• Непідтримуване вхідне завдання: input_task_id не є успішно завершеним завданням підтримуваного типу, створеним за допомогою Meshy 6 або Meshy 7.
• Немає референсного зображення: mode має значення by_color, а вхідні дані не були створені із завантаженого зображення.
• З'єднувач поза діапазоном: connector_size або connector_height виходить за межі діапазону 0.1–0.8.

Виправте запит і надішліть його знову. Див. Помилки.

API-ключ відсутній або недійсний. Перевірте заголовок Authorization.

Наприклад:

• Недостатньо кредитів: обліковий запис не має достатньо кредитів для цього завдання, або обліковий запис досяг ліміту кредитів. Перевірте баланс кредитів, потім повторіть спробу.
• Безкоштовний план: для створення завдання потрібен платний план. Оновіть свій план у налаштуваннях підписки, потім повторіть спробу.

Застосовується один із таких випадків:

• Модерація контенту заблокувала prompt. Повідомлення — explicit content або prohibited content. Змініть prompt, потім повторіть спробу.
• input_task_id вказує на модель-барельєф, яку ця кінцева точка не може розрізати. Повідомлення — This model type does not support this operation. Надішліть іншу модель.

input_task_id не існує або не належить вашому обліковому запису. Перевірте ID та використовуйте API-ключ облікового запису, який створив завдання.

Ви перевищили обмеження частоти. Зачекайте, потім повторіть спробу. Див. Обмеження частоти.

Запити by_parts та by_color також спільно використовують ліміт зчитування prompt — 12 запитів на хвилину на обліковий запис.

Розділення за prompt (by_parts та by_color) тимчасово недоступне. Повторіть спробу пізніше, або надішліть mode: "auto", який все ще працює. Meshy не стягує плату за цей запит.

ID завдання з відповіді на створення.

ID завдання, яке потрібно видалити.

Номер сторінки для повернення. Починається з 1 і за замовчуванням дорівнює 1.

Кількість завдань на сторінці, до 100. За замовчуванням 10. Meshy трактує більше значення як 100.

Порядок сортування.

Доступні значення:

• +created_at: спочатку найстаріші
• -created_at: спочатку найновіші

ID завдання з відповіді створення.

ID задачі. Розглядайте його як непрозорий рядок і не покладайтеся на його формат.

Тип задачі, завжди print-split.

URL-адреси для завантаження розділеної моделі, по одній на кожен запитаний формат. Формат, який ви не запитали, не має ключа. Формати, що підтримують об'єкти сцени, зберігають кожну частину як окремий об'єкт, а stl об'єднує частини в одне суцільне тіло.

URL-адреса для завантаження попереднього зображення розділеної моделі в запитаному layout. Коли частини зберігають текстуру, попередній перегляд показує її. Інакше кожна частина має свій власний колір.

Текстурні карти розділеної моделі у вигляді масиву з одним об'єктом. Усі частини мають спільні карти. Присутнє лише коли keep_texture має значення true, а вхідна модель текстурована.

URL-адреса для завантаження версії thumbnail_url з прозорим фоном (RGBA). Присутнє лише після успішного завершення задачі, коли Meshy відрендерив прозорий попередній перегляд.

Чи проігнорував Meshy prompt. Значення true, коли prompt запиту by_parts або by_color не називав жодної частини, тому Meshy розділив модель автоматично. Назви частин у результаті тоді належать Meshy, а не вам. Присутнє, починаючи зі статусу PENDING. Meshy не додає це поле для задач auto та завжди, коли він дотримувався prompt.

Кількість придатних для друку частин, отриманих у результаті розподілу. Формати, що підтримують об'єкти сцени, зберігають один об'єкт на частину. stl об'єднує частини в одне суцільне тіло, але part_count все одно їх рахує. Перед експортом Meshy видаляє злиплі уламки, які не можуть стати придатною для друку частиною, і не враховує їх.

Наскільки виконана задача, у відсотках. Значення 0, доки задача не почалася, і 100, коли вона успішно завершена.

Статус задачі, один із PENDING, IN_PROGRESS, SUCCEEDED, FAILED або CANCELED.

Кількість задач попереду цієї в черзі. Значення має сенс лише, доки задача має статус PENDING.

Час створення задачі, у мілісекундах Unix.

Час початку виконання задачі, у мілісекундах Unix. Значення 0, доки задача не почалася.

Час завершення задачі, у мілісекундах Unix. Значення 0, доки задача не завершиться.

Час, коли закінчується термін дії результату задачі, у мілісекундах Unix. Значення 0, доки задача не завершиться.

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

Якщо перевірка безпеки відхиляє вхідну модель, задача завершується невдало з task_error.type, встановленим у invalid_input, і task_error.code, встановленим у provider_content_refused. Надішліть іншу модель. Див. Помилки.

З keep_texture: true, якщо Meshy не може зберегти текстуру, задача завершується невдало з task_error.code, встановленим у textured_split_refused. Див. Помилки.

Кількість кредитів, використаних задачею. Це поле завжди присутнє. Значення 10 після того, як Meshy прийняв задачу, і 0 для задачі зі статусом FAILED, оскільки Meshy повертає кредити, коли задача завершується невдало. Видалення задачі зі статусом PENDING також повертає кредити.