Repair Printability API

Обязателен, если вы не отправляете model_url. ID задачи, модель которой вы хотите восстановить, например задачи Изображение в 3D, Мульти-изображение в 3D, Текст в 3D, Ремешинг, Ретекстурирование или Анализ пригодности к печати. Задача должна быть создана вами через API, иметь статус SUCCEEDED и GLB-модель.

Задача Анализ пригодности к печати, которая проверяла толщину стенки, также передаёт свой принтер и размер. Восстановление в этом случае проверяет толщину стенки и утолщает тонкие стенки, даже если вы не отправите ни один из параметров. Отправленный вами printer_type или размер печати заменяет значения из анализа. Задача Анализ пригодности к печати для файла .stl, .fbx или .gltf из model_url не работает. Вместо этого отправьте этот файл как model_url.

Обязателен, если вы не отправляете input_task_id. Модель для восстановления в виде публичного URL или data URI. Если вы отправите оба параметра, Meshy использует input_task_id.

При передаче через http- или https-URL модель должна быть файлом .glb, .gltf, .obj, .fbx или .stl размером не более 400 МБ. Data URI может содержать только base64-файл GLB (data:model/gltf-binary;base64,...) или glTF (data:model/gltf+json;base64,...) размером не более 100 МБ. Отправляйте файл .obj, .fbx или .stl как http- или https-URL.

Файл размером более 100 МБ также должен соответствовать следующим правилам:

• Файл GLB, glTF, FBX или OBJ может содержать не более 10 000 000 граней. Meshy считает грани как треугольники, поэтому четырёхугольник считается за 2, а сетка, нарисованная более одного раза, считается один раз за каждую копию.
• Файл FBX должен быть в бинарном формате FBX 7.1 или новее.
• Файл GLB или glTF не должен использовать сжатие Draco.

URL для загрузки Meshy (assets.meshy.ai/…?Expires=…&Signature=…) подписан и перестаёт работать по истечении expires_at его задачи. Повторное чтение задачи не обновляет его. Для модели, созданной вами в Meshy, отправляйте вместо этого input_task_id, который работает, пока Meshy хранит исходную задачу (см. Хранение ресурсов). Чтобы использовать модель после этого, скачайте её до expires_at и отправьте свою собственную копию.

Нужно ли также отрендерить превью с прозрачным фоном (RGBA), возвращаемое в alpha_thumbnail_url при получении задачи. thumbnail_url при этом не изменяется.

Принтер, который вы планируете использовать. Он задаёт минимальную толщину стенки, к которой стремится восстановление. Если вы отправите размер печати без printer_type, Meshy использует fdm, если только задача Анализ пригодности к печати в input_task_id не предоставляет принтер.

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

• fdm: нить, минимальная толщина стенки 1,0 мм
• sla: смола, минимальная толщина стенки 0,8 мм
• full_color: полноцветная печать, минимальная толщина стенки 2,0 мм

Любое другое значение возвращает 400.

Высота печати в миллиметрах, от 1 до 1000. Значение вне диапазона возвращает 400. Отправьте этот параметр или intended_print_longest_side_mm, но не оба одновременно.

Работает только с входными данными GLB. Для model_url, который не является файлом .glb, отправляйте вместо этого intended_print_longest_side_mm.

Длина самой длинной стороны печати в миллиметрах, от 1 до 1000. Значение вне диапазона возвращает 400. Работает с любым форматом входных данных.

Запрос не может быть выполнен. Сообщение об ошибке указывает, какая проблема была обнаружена. Например:

• Отсутствует параметр: Не был отправлен ни input_task_id, ни model_url.
• Недопустимый UUID: input_task_id не является допустимым UUID.
• Недопустимый URL модели: model_url некорректен, использует неподдерживаемую схему или имеет неподдерживаемое расширение файла.
• Файл модели слишком большой: Файл model_url превышает 400 МБ при передаче через http- или https-URL, либо превышает 100 МБ в виде data URI.
• Слишком много граней: Файл model_url — это файл GLB, glTF, FBX или OBJ размером более 100 МБ с более чем 10 000 000 граней. Уменьшите количество граней, затем отправьте файл снова.
• ASCII FBX более 100 МБ: Файл model_url — это ASCII FBX размером более 100 МБ. Отправьте его как бинарный FBX или GLB.
• Нечитаемый файл модели: Файл model_url превышает 100 МБ, и Meshy не может прочитать его заголовок. Например, это GLB или glTF со сжатием Draco, или бинарный FBX старше версии 7.1.
• Заголовок модели слишком сложный: Файл model_url превышает 100 МБ, и его заголовок содержит слишком много сеток, узлов или записей для проверки. Уменьшите количество объектов в файле, затем отправьте его снова.
• Не удаётся скачать файл модели: model_url вернул ошибку, чаще всего потому, что истёк срок действия подписанного URL для загрузки Meshy. Повторное чтение задачи возвращает тот же URL с тем же сроком действия. Отправьте свою собственную копию файла или отправьте input_task_id, пока Meshy хранит исходную задачу.
• Задача не завершена успешно: Задача input_task_id всё ещё ожидает выполнения, выполняется или завершилась с ошибкой.
• Отсутствует GLB: У задачи input_task_id нет GLB-модели для восстановления.
• Недопустимый размер печати: intended_print_height_mm или intended_print_longest_side_mm выходит за пределы диапазона от 1 до 1000, либо в запросе присутствуют оба параметра.
• Неизвестный тип принтера: printer_type не является fdm, sla или full_color.
• Высота для модели, не являющейся GLB: В запросе указан intended_print_height_mm, а model_url не является файлом .glb. Вместо этого отправьте intended_print_longest_side_mm.
• Невозможно задать размер этой модели по высоте: При запрошенной высоте или высоте по умолчанию 150 мм самая длинная сторона модели выходила бы за пределы диапазона от 1 до 1000 мм. Это также происходит, когда модель плоская, или когда Meshy не может определить её размер. Вместо этого отправьте intended_print_longest_side_mm. Для model_url в формате .glb и некоторых задач input_task_id Meshy обнаруживает это только после начала выполнения задачи, и задача завершается со статусом FAILED.
• Непригодный размер STL: В запросе указан printer_type без размера, и Meshy не может прочитать собственную самую длинную сторону файла .stl, либо она выходит за пределы диапазона от 1 до 1000 мм. Отправьте intended_print_longest_side_mm.

Исправьте запрос, затем отправьте его снова. См. Ошибки.

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

Например:

• Недостаточно кредитов: На счету недостаточно кредитов для выполнения этой задачи, либо достигнут лимит кредитов. Проверьте баланс кредитов, затем повторите попытку.
• Бесплатный план: Для создания задачи требуется платный план. Обновите свой план в настройках подписки, затем повторите попытку.

input_task_id — это модель барельефа, которую этот эндпоинт не может восстановить. Сообщение: This model type does not support this operation. Отправьте другую модель.

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

Вы превысили ограничение частоты запросов, или у вас слишком много задач в ожидании. Подождите, затем повторите попытку. См. Ограничения частоты.

ID задачи из ответа на создание.

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

Номер страницы для возврата, начиная с 1.

Количество задач на странице, до 100.

Порядок сортировки.

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

• +created_at: сначала самые старые
• -created_at: сначала самые новые

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

ID задачи. Рассматривайте его как непрозрачную строку и не полагайтесь на её формат.

Тип задачи, всегда print-repair.

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

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

Количество задач перед этой в очереди. Значение имеет смысл только пока задача находится в статусе PENDING.

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

Время начала выполнения задачи, в миллисекундах Unix. Равно 0, пока задача не началась.

Время завершения задачи, в миллисекундах Unix. Равно 0, пока задача не завершена.

Время истечения срока действия результата задачи, в миллисекундах Unix. Равно 0, пока задача не завершена.

Подробности об ошибке, если задача завершилась неудачно. Равно null, если задача не завершилась ошибкой. См. Ошибки.

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

URL-адрес для скачивания превью-изображения восстановленной модели.

URL-адрес для скачивания версии thumbnail_url с прозрачным фоном (RGBA). Присутствует только если вы создали задачу с alpha_thumbnail: true и Meshy отрендерил прозрачное превью.

Всегда пустой массив. Восстановление сохраняет только входную геометрию и не перезапекает текстуры.

Количество кредитов, использованных задачей. Равно 10, когда задача имеет статус SUCCEEDED, и 0 для задачи со статусом FAILED, поскольку Meshy возвращает кредиты, если задача завершается неудачно.

Принтер и размер, использованные при восстановлении, независимо от того, отправили ли вы их сами или Meshy повторно использовал их из задачи Analyze Printability. Присутствует с самого начала при восстановлении толщины стенки, в том числе пока задача находится в статусе PENDING. Значение, которое Meshy ещё не знает, равно null.

Что сделало восстановление толщины стенки. Присутствует после успешного завершения восстановления толщины стенки.