API ремешинга

ID завершенной задачи Изображение в 3D или Текст в 3D, которую вы хотите ремешить. Эта задача должна быть одной из следующих: Предпросмотр Текст в 3D, Уточнение Текст в 3D, Изображение в 3D или Ретекстурирование. Кроме того, она должна иметь статус SUCCEEDED.

Предоставьте 3D-модель для Meshy для ремешинга через общедоступный URL или Data URI. Поддерживаемые форматы: .glb, .gltf, .obj, .fbx, .stl.

Для Data URI используйте MIME type: application/octet-stream.

Список целевых форматов для модели после ремешинга. Если параметр не указан, создается только GLB.

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

Укажите topology сгенерированной модели.

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

• quad: Сгенерировать сетку с преобладанием четырехугольников.
• triangle: Сгенерировать упрощенную треугольную сетку.

Укажите целевое число полигонов в сгенерированной модели. Фактическое число полигонов может отличаться от целевого в зависимости от сложности геометрии.

Диапазон допустимых значений зависит от уровня пользователя:

• От 100 до 300 000 (включительно)

Включите адаптивное упрощение, задав уровень числа полигонов. Если параметр задан, target_polycount игнорируется.

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

• 1: Адаптивный — сверхвысокое число полигонов.
• 2: Адаптивный — высокое число полигонов.
• 3: Адаптивный — среднее число полигонов.
• 4: Адаптивный — низкое число полигонов.

Изменить размер модели до определенной высоты, измеряемой в метрах. Вместо этого мы рекомендуем использовать специализированный Resize API.

Изменить размер модели так, чтобы самая длинная сторона ограничивающего параллелепипеда равнялась указанному значению в метрах. Вместо этого мы рекомендуем использовать специализированный Resize API.

При значении true сервис использует AI-зрение, чтобы автоматически оценить реальную высоту объекта и соответствующим образом изменить размер модели. Вместо этого мы рекомендуем использовать специализированный Resize API.

Если true, сервис изменит только формат входного файла модели, игнорируя другие входные данные, такие как topology, resize_height и target_polycount. Вместо этого мы рекомендуем использовать специализированный Convert API.

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

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

• Отсутствующий параметр: Необходимо предоставить либо model_url, либо input_task_id.
• Недопустимая входная задача: input_task_id должен ссылаться на успешную задачу из поддерживаемой модели.
• Недопустимый формат модели: model_url указывает на файл с неподдерживаемым расширением.
• Недоступный URL: Не удалось скачать model_url.
• Недопустимый topology: Параметр topology недопустим.
• Взаимоисключающие параметры: auto_size и resize_height не могут быть установлены одновременно.

Аутентификация не удалась. Проверьте свой API-ключ.

Недостаточно кредитов для выполнения этой задачи.

Вы превысили свое ограничение частоты.

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

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

Номер страницы для пагинации.

Лимит размера страницы. Максимально допустимое значение — 50 элементов.

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

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

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

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

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

Тип задачи Ремешинга. Значение — remesh.

URL для скачивания файла текстурированной 3D-модели, сгенерированного Meshy. Свойство для формата будет опущено, если формат не сгенерирован, вместо возврата пустой строки.

URL для скачивания изображения предпросмотра, отрендеренного из модели после ремешинга.

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

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

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

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

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

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

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

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

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