Восстановление пригодности к печати API

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

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

URL 3D-модели для восстановления. Поддерживаемые форматы: .glb, .gltf, .obj, .fbx, .stl. Используйте URL http или https, либо base64 URL data: для GLB (data:model/gltf-binary;base64,...) или glTF (data:model/gltf+json;base64,...). Файлы .obj, .fbx и .stl должны быть отправлены как URL http или https.

Максимальный размер файла: 400 МБ для URL http или https, 100 МБ для URI data:.

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

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

Если установлено значение true, задача дополнительно рендерит версию превью с прозрачным фоном (RGBA) и возвращает её как alpha_thumbnail_url в ответе GET. Существующее поле thumbnail_url остаётся без изменений.

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

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

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

Высота печати в миллиметрах. Диапазон: [1, 1000]. Округляется до ближайшего миллиметра. Только для входных данных GLB.

Длина самой длинной стороны печати в миллиметрах. Диапазон: [1, 1000]. Округляется до ближайшего миллиметра. Работает со всеми входными форматами.

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

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

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

Распространённые причины:

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

Указанная задача не существует или принадлежит другому пользователю.

Вы превысили квоту ожидающих задач или ограничение частоты.

ID задачи восстановления пригодности к печати, которую требуется получить.

ID задачи восстановления пригодности к печати, которую нужно удалить.

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

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

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

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

Уникальный идентификатор задачи восстановления пригодности к печати для потоковой передачи.

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

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

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

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

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

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

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

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

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

Информация об ошибке, если задача завершилась неудачно. Это свойство равно null, если задача не завершилась неудачно. См. Ошибки для подробностей.

Ссылки для скачивания восстановленной 3D-модели. Заполняется только поле, соответствующее входному формату; остальные поля форматов — пустые строки.

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

Ссылка для скачивания версии thumbnail_url с прозрачным фоном (RGBA). Присутствует только если задача была создана с параметром alpha_thumbnail: true и прозрачное превью было успешно отрендерено; в противном случае это поле отсутствует.

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

Количество кредитов, потреблённых этой задачей. 10, как только задача достигла статуса SUCCEEDED. Возвращает 0 для задач со статусом FAILED (кредиты возвращаются при неудаче).

Принтер и размер, использованные при восстановлении, — переданные явно или унаследованные из задачи анализа. Присутствует с самого начала (PENDING) для восстановления толщины стенки; значения, которые ещё не известны, равны null.

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