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.

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

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

• 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.

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

Ссылка для скачивания рендер-превью разделённой модели, где каждая часть окрашена в свой цвет, в запрошенной раскладке (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, также приводит к возврату кредитов.