API Ремешинга

ID завершённой задачи Изображение в 3D или Текст в 3D, которую вы хотите ремешить. Эта задача должна быть одной из следующих: Text to 3D Preview, Text to 3D Refine, Изображение в 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 задачи ремешинга, которую нужно удалить.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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