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 граней. Модель с большим числом граней возвращает 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 раскладывает части плашмя и распределяет их по рабочей платформе, готовыми к нарезке. Это та же компоновка, что и в режиме On Plate в веб-приложении.

В обоих вариантах layout 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 также возвращает кредиты.