API Ремешинга

Обязателен, если не отправлен model_url. ID задачи, модель которой вы хотите ремешировать, например задачи Текст в 3D, Изображение в 3D, Ретекстурирование или Ремешинг. Задача должна быть создана вами через API и иметь статус SUCCEEDED.

Обязателен, если не отправлен input_task_id. Модель для ремешинга в виде публичного URL или data URI. Если отправлены оба параметра, Meshy использует input_task_id.

Модель должна быть файлом в формате GLB, glTF, OBJ, FBX или STL размером не более 400 МБ при передаче по http или https URL, или не более 100 МБ в виде data URI. Для data URI используйте MIME type application/octet-stream.

Файл размером более 100 МБ также должен соответствовать следующим правилам:

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

Форматы файлов для генерации.

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

• glb
• fbx
• obj
• usdz
• blend
• stl
• 3mf

Тип граней ремешированной модели.

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

• quad: сетка с преобладанием четырёхугольников
• triangle: децимированная треугольная сетка

Целевое количество граней, от 100 до 300000. Результат может отличаться от целевого значения в зависимости от геометрии модели. Значение вне диапазона возвращает 400.

Адаптивное количество граней по уровню. При установке этого параметра Meshy игнорирует target_polycount.

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

• 1: ультра
• 2: высокий
• 3: средний
• 4: низкий

Используйте вместо этого Resize API. Высота, до которой нужно изменить размер модели, в метрах. Отправьте не более одного из параметров resize_height, resize_longest_side и auto_size.

Используйте вместо этого Resize API. Длина, до которой нужно изменить самую длинную сторону ограничивающего параллелепипеда модели, в метрах. Отправьте не более одного из параметров resize_height, resize_longest_side и auto_size.

Используйте вместо этого Resize API. Указывает, нужно ли оценить реальную высоту объекта с помощью ИИ-зрения и изменить размер модели в соответствии с ней. Отправьте не более одного из параметров resize_height, resize_longest_side и auto_size.

Используйте вместо этого Resize API. Куда поместить начало координат модели: bottom или center. Значение по умолчанию применяется, когда вы отправляете resize_height, resize_longest_side или auto_size. Без одного из них Meshy перемещает начало координат, только если вы отправили origin_at.

Используйте вместо этого Convert API. Указывает, следует ли только конвертировать модель в форматы target_formats. Когда указано true, Meshy игнорирует topology, target_polycount, decimation_mode, resize_height, resize_longest_side и auto_size, но всё равно проверяет их значения, поэтому недопустимое значение вернёт 400. При convert_format_only: true пустое значение или null в target_formats вернёт 400.

Указывает, нужно ли также рендерить предпросмотр с прозрачным фоном (RGBA), который возвращается в alpha_thumbnail_url при получении задачи. thumbnail_url при этом не меняется.

Запрос не может быть выполнен. Сообщение об ошибке указывает, какая проблема была обнаружена. Например:

• Отсутствует параметр: не отправлены ни model_url, ни input_task_id.
• Недопустимая исходная задача: input_task_id не является успешной задачей API, или её ИИ-модель не поддерживает ремешинг.
• Недопустимый формат модели: файл model_url имеет неподдерживаемое расширение.
• Недоступный URL: Meshy не может загрузить файл по model_url.
• Файл модели слишком большой: файл model_url превышает 400 МБ при передаче по http или https URL, или превышает 100 МБ в виде data URI.
• Слишком много граней: файл model_url превышает 100 МБ и содержит более 10 000 000 граней. Уменьшите количество граней, затем отправьте файл снова.
• ASCII FBX более 100 МБ: файл model_url является ASCII FBX размером более 100 МБ. Отправьте его в виде бинарного FBX или GLB.
• Нечитаемый файл модели: файл model_url превышает 100 МБ, и Meshy не может прочитать его заголовок. Например, это GLB или glTF со сжатием Draco, или бинарный FBX старше версии 7.1.
• Заголовок модели слишком сложен: файл model_url превышает 100 МБ, и его заголовок содержит слишком много сеток, узлов или записей для проверки. Уменьшите количество объектов в файле, затем отправьте его снова.
• Недопустимая topology: topology не равна quad или triangle.
• Взаимоисключающие параметры: в запросе указано более одного из параметров auto_size, resize_height и resize_longest_side. Отправьте только один.

Исправьте запрос, затем отправьте его снова. См. Ошибки.

API-ключ отсутствует или недействителен. Проверьте заголовок Authorization.

Например:

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

input_task_id относится к модели барельефа, которую этот эндпоинт не может ремешировать. Сообщение гласит: This model type does not support this operation. Отправьте другую модель.

input_task_id не соответствует ни одной из ваших задач. Проверьте ID задачи, затем отправьте запрос снова.

Вы превысили ограничение частоты запросов. Подождите, затем повторите попытку. См. Ограничения частоты.

ID задачи из ответа на создание.

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

Номер страницы, которую нужно вернуть, до 255. Большее значение вернёт 400.

Количество задач на странице, до 100.

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

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

• +created_at: сначала старые
• -created_at: сначала новые

ID задачи, полученный в ответе на создание.

ID задачи. Рассматривайте его как непрозрачную строку и не полагайтесь на её формат.

Тип задачи, всегда remesh.

URL-адреса для скачивания ремешированной модели, по одному на каждый формат файла. Формат, который задача не сгенерировала, не имеет ключа, вместо пустой строки.

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

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

Какая часть задачи выполнена, в процентах. Значение равно 0, пока задача не началась, и 100, когда она завершена успешно.

Статус задачи, один из: PENDING, IN_PROGRESS, SUCCEEDED, FAILED или CANCELED.

Количество задач впереди этой в очереди. Значение имеет смысл только пока задача находится в статусе PENDING.

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

Время начала задачи, в миллисекундах Unix. Значение равно 0, пока задача не началась.

Время завершения задачи, в миллисекундах Unix. Значение равно 0, пока задача не завершилась.

Время, когда истекает срок действия URL-адресов для скачивания задачи, в миллисекундах Unix. Значение равно 0, пока задача не завершилась.

URL-адреса для скачивания текстурных карт модели, когда задача завершена успешно: массив объектов, по одному на каждый набор текстур. Каждый объект содержит URL base_color, а также может содержать URL metallic, roughness, normal, emission и metallic_roughness. Значение равно null, пока задача не завершена успешно, и является пустым массивом, если у модели нет текстурных карт.

Детали ошибки, если задача завершилась неудачей. См. Ошибки.

Количество кредитов, использованных задачей. Присутствует, когда статус — PENDING, IN_PROGRESS или SUCCEEDED. Значение равно 0 для задачи со статусом FAILED, поскольку Meshy возвращает кредиты, если задача завершается неудачей.