Auto Split API

ID успешно завершённой задачи, чью модель нужно разделить. Поддерживаемые типы задач: Изображение в 3D, Мульти-изображение в 3D, Текст в 3D (превью), Ремешинг, Конвертировать и Изменить размер. Задача должна иметь статус SUCCEEDED, а её модель должна быть сгенерирована с помощью Meshy 6 или Meshy 7 (ai_model meshy-6, meshy-7, meshy-7.1 или latest). Низкополигональные модели и модели Smart Topology (meshy-t2) не поддерживаются. Текстурированная модель принимается, но её текстура не переносится в результат.

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

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

• auto: Meshy сама выбирает места разрезов. prompt игнорируется.
• by_parts: Разрезать по структурным частям, названным в prompt, таким как голова, руки и торс.
• by_color: Разрезать по цветовым областям, названным в prompt. Требует входные данные, сгенерированные из загруженного изображения (Изображение в 3D или Мульти-изображение в 3D); остальные входные данные отклоняются с ошибкой 400. Границы цветовых областей берутся из исходного изображения, а не из текстуры входной модели. Для Мульти-изображение в 3D Auto Split использует первое исходное изображение.

Форматы, в которых экспортируется разделённая модель. Форматы, поддерживающие объекты сцены (glb, obj, fbx, usdz, blend, 3mf), содержат каждую часть как отдельный объект; у stl нет понятия отдельных объектов, поэтому он объединяет все части в одно тело, расположенное согласно layout (запросите 3mf, если нужны отдельно выбираемые части в слайсере). glb создаётся всегда и возвращается в model_urls; перечислите любые другие нужные форматы дополнительно.

Доступные значения: glb, obj, fbx, stl, usdz, blend, 3mf.

Как части расположены в каждом выходном формате и на миниатюре.

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

• assembled: Части остаются там, где они находились в исходной модели.
• on_plate: Части выкладываются плоско и разложены на печатной платформе, готовые к нарезке в слайсере — так же, как в режиме On Plate веб-приложения.

В обоих вариантах компоновки схлопнувшийся тонкий или точкообразный фрагмент, оставшийся после разреза, удаляется перед экспортом, так что каждая полученная часть пригодна для печати. Форматы, поддерживающие объекты сцены, содержат по одному объекту на часть; stl объединяет их в единое тело.

Добавляет соединители типа «шип-паз» в каждом месте разреза, чтобы напечатанные части можно было соединить друг с другом.

Запрос был некорректным. Распространённые причины:

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

Ошибка аутентификации. Проверьте свой API-ключ.

Недостаточно кредитов для выполнения этой задачи.

input_task_id не существует или не принадлежит вашему аккаунту.

Вы превысили ограничение частоты запросов. Запросы by_parts и by_color также имеют общее ограничение на разбор prompt — 12 запросов в минуту на аккаунт.

Разделение на основе prompt (by_parts и by_color) временно недоступно. Повторите попытку позже или используйте mode: "auto", на который это не влияет. Списание не производится.

ID задачи Auto Split, которую нужно получить.

ID задачи Auto Split, которую нужно удалить.

Номер страницы для пагинации. Начинается со значения 1, которое также является значением по умолчанию.

Ограничение размера страницы. По умолчанию 10 элементов. Максимально допустимое значение — 100 элементов; большие значения ограничиваются до 100.

Поле для сортировки. Доступные значения:

• +created_at: сортировка по времени создания в порядке возрастания.
• -created_at: сортировка по времени создания в порядке убывания.

Уникальный идентификатор задачи Auto Split, для которой запрашивается стрим.

Уникальный идентификатор задачи. Хотя в качестве деталей реализации мы используем k-sortable UUID для идентификаторов задач, вам не следует делать каких-либо предположений о формате id.

Тип задачи. Значение — print-split.

Ссылки для скачивания разбитой модели, по одной на каждый запрошенный формат. Форматы, поддерживающие объекты сцены, сохраняют каждую часть как отдельный объект; stl объединяет их в одно твёрдое тело. Свойство для формата будет отсутствовать, если этот формат не был запрошен.

Ссылка для скачивания отрендеренного превью разбитой модели, где каждая часть выделена своим цветом, в запрошенной layout.

true, если в prompt запроса by_parts или by_color не были названы части, из-за чего Meshy выполнила разбиение модели автоматически — названия частей в результате принадлежат Meshy, а не вам. Присутствует начиная со статуса PENDING. Отсутствует для задач auto, а также во всех случаях, когда prompt был учтён.

Количество печатаемых частей, полученных в результате разбиения. Форматы, поддерживающие объекты сцены, содержат по одному объекту на часть; stl объединяет их в одно твёрдое тело, при этом счётчик по-прежнему отражает количество частей. Схлопнувшиеся фрагменты, которые сегментация не смогла превратить в печатаемую деталь, удаляются из файлов перед экспортом и не учитываются в счётчике.

Прогресс выполнения задачи. Если задача ещё не началась, это свойство будет равно 0. После успешного завершения задачи оно станет равно 100.

Статус задачи. Возможные значения: одно из PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Количество предшествующих задач.

Временная метка создания задачи, в миллисекундах.

Временная метка начала выполнения задачи, в миллисекундах. Если задача ещё не началась, это свойство будет равно 0.

Временная метка завершения задачи, в миллисекундах. Если задача ещё не завершена, это свойство будет равно 0.

Сведения об ошибке для неудавшихся задач. Полное описание объекта task_error см. в разделе Ошибки.

Количество кредитов, потраченных на выполнение этой задачи. Присутствует всегда: 10 после принятия задачи в обработку и 0 для задач со статусом FAILED, поскольку списание возвращается при неудаче. Удаление задачи, пока она ещё находится в статусе PENDING, также возвращает списанные кредиты.