Auto Split API

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

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

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

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

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

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

3mf создаётся для слайсеров: один объект на часть, каждый в своём собственном слоте филамента, поэтому Bambu Studio открывает файл как отдельно окрашенные, отдельно выбираемые части (архив содержит конфигурацию проекта Bambu Studio; другие слайсеры считывают только геометрию). Как и другие форматы для печати в Meshy, этот формат использует миллиметры, и, поскольку этот эндпоинт не принимает целевой размер, вся модель масштабируется так, чтобы её самая длинная сторона составляла 150 мм — тот же предел, который используется в других экспортах для печати, выбранный так, чтобы модель поместилась на большинстве стандартных столов для печати. При layout: "on_plate" этот предел применяется ко всей разложенной на столе модели целиком, поэтому файл сразу готов к нарезке в слайсере; при assembled части остаются на тех местах, где они находились в исходной модели, и вы располагаете их в слайсере самостоятельно.

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

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

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

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

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

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

• Отсутствует prompt: prompt обязателен, если mode равен by_parts или by_color.
• Prompt называет менее двух частей: для by_parts / by_color требуется как минимум две названные детали (например, head, torso, base); общая инструкция вроде split into individual parts отклоняется. Списание не производится.
• Неподдерживаемая исходная задача: input_task_id должен ссылаться на успешно выполненную задачу поддерживаемого типа, сгенерированную с использованием Meshy 6 или Meshy 7.
• Текстурированный ввод: у исходной модели есть текстуры. На данный момент поддерживаются только модели без текстур.
• Нет референсного изображения: by_color требует ввода, сгенерированного из загруженного изображения.
• Неподдерживаемый формат: target_formats содержит stl.
• Значение соединителя вне диапазона: 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.

Скачиваемые URL-адреса разделённой модели, по одному на каждый запрошенный формат. Каждая часть представлена отдельным объектом в файле. Свойство для формата будет отсутствовать, если этот формат не был запрошен.

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

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

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

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

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

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

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

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

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

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

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