Remesh API

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