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 vision для автоматической оценки реальной высоты объекта и изменения размера модели соответственно. Мы рекомендуем использовать специализированный 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 и прозрачный предварительный просмотр был успешно отрендерен; в противном случае это поле опущено.

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

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

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

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

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

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

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

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