Retexture API

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

При использовании meshy-n1 модель задачи может иметь не более 7 999 999 граней, считая по треугольникам (четырёхугольник считается за 2).

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

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

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

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

При использовании meshy-n1 модель может иметь не более 7 999 999 граней, считая по треугольникам (четырёхугольник считается за 2), независимо от размера файла.

Обязателен, если не отправлен image_style_url или multiview_image_urls. Текст, описывающий желаемую текстуру, до 800 символов. Более длинный текст возвращает 400. При использовании meshy-n1 отправка без image_style_url возвращает 400.

Обязателен, если не отправлен text_style_prompt или multiview_image_urls. 2D-изображение, стилю которого должна следовать текстура, как публичный URL или data URI (data:image/jpeg;base64,<ваши данные изображения в base64>). Если отправлены оба параметра, text_style_prompt и image_style_url, Meshy использует image_style_url.

Изображение должно быть файлом .jpg, .jpeg, .png или .webp размером не более 20 МБ и не менее 32 пикселей с каждой стороны.

Текстура может плохо подойти, если объект на изображении имеет форму, сильно отличающуюся от модели. При использовании meshy-n1 Meshy трактует изображение как вид спереди.

Обязателен, если не отправлен text_style_prompt или image_style_url. От одного до четырёх изображений одного и того же объекта с разных ракурсов. Первое изображение — основной вид (спереди). Порядок остальных ракурсов (слева, сзади, справа) не важен. Пустой массив или более четырёх изображений возвращают 400.

Каждое изображение подчиняется тем же правилам формата и размера, что и image_style_url, не более 20 МБ на изображение. Нельзя сочетать multiview_image_urls с text_style_prompt или image_style_url.

multiview_image_urls требует явного указания ai_model со значением meshy-7 или meshy-n1. Любой другой ai_model, включая значение по умолчанию latest, возвращает 400.

AI-модель, генерирующая текстуру.

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

• meshy-6-lite
• meshy-6
• meshy-7
• meshy-n1: 2K-текстура базового цвета только по референсным изображениям. Без текстового prompt, без PBR-карт, без 4K или 8K. До 7 999 999 граней.
• latest: Meshy 7

Сохранять ли UV-раскладку модели вместо создания новой.

• Для модели, созданной Meshy, из input_task_id или model_url, указывающего на результат работы Meshy, используйте true, чтобы повторно использовать её оптимизированную UV-раскладку.
• Для модели, загруженной из другого источника, используйте true, чтобы сохранить уже хорошие UV. Оставьте false, чтобы Meshy создала новые UV, что подходит для модели без корректной UV-разметки.

Генерировать ли также PBR-карты (металличность, шероховатость и нормали) вместе с базовым цветом. При использовании meshy-6 Meshy также генерирует карту эмиссии, кроме случая texture_resolution со значением 8k. meshy-6-lite, meshy-7 и latest не генерируют карту эмиссии. При использовании meshy-n1 значение true возвращает 400.

Размер текстуры базового цвета. Более высокое разрешение захватывает больше деталей поверхности.

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

• 2k: 2048 × 2048 пикселей
• 4k: 4096 × 4096 пикселей
• 8k: 8192 × 8192 пикселей

4k и 8k требуют ai_model со значением meshy-6, meshy-7 или latest. При использовании meshy-6-lite или meshy-n1 они возвращают 400. При 8k Meshy не генерирует карту эмиссии.

Используйте вместо этого texture_resolution. true эквивалентно texture_resolution: "4k". Если отправлены оба параметра, Meshy использует texture_resolution.

Удалять ли блики и тени из текстуры базового цвета. Результат лучше работает при вашем собственном освещении.

Meshy применяет это только с meshy-6, при texture_resolution со значением 2k или 4k. С meshy-7 или latest, либо при 8k, Meshy принимает параметр, но игнорирует его. При использовании meshy-6-lite или meshy-n1 отправка этого параметра с любым значением возвращает 400.

Форматы файлов для генерации. Meshy генерирует только указанные вами форматы, что может сократить время выполнения задачи. Если параметр не указан, Meshy генерирует все форматы, кроме 3mf.

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

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

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

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

• Отсутствует параметр: не отправлены ни model_url, ни input_task_id.
• Отсутствует стиль: не отправлен ни один из параметров text_style_prompt, image_style_url и multiview_image_urls.
• Конфликтующие входные данные стиля: multiview_image_urls отправлен вместе с text_style_prompt или image_style_url.
• Неподдерживаемая модель для мультивида: multiview_image_urls отправлен без явного указания ai_model со значением meshy-7 или meshy-n1.
• Неподдерживаемая опция для Meshy N1: с meshy-n1 отправлены enable_pbr: true, remove_lighting, texture_resolution со значением 4k или 8k, hd_texture: true без texture_resolution, либо text_style_prompt без image_style_url.
• Слишком много треугольников для Meshy N1: при использовании meshy-n1 3D-модель содержит более 7 999 999 треугольников. Уменьшите количество треугольников или используйте другую ai_model.
• Модель слишком сложна для Meshy N1: при использовании meshy-n1 файл model_url слишком сложен, чтобы Meshy могла посчитать его треугольники. Уменьшите количество треугольников, затем отправьте файл снова.
• Превышено время подсчёта треугольников: при использовании meshy-n1 подсчёт треугольников файла model_url занял слишком много времени. Повторите попытку или уменьшите размер модели.
• Недопустимая исходная задача: input_task_id не является успешно выполненной задачей поддерживаемого типа.
• Недопустимый формат модели: файл model_url имеет неподдерживаемое расширение.
• Недоступный URL: Meshy не может загрузить файл model_url, изображение image_style_url или изображение из multiview_image_urls.
• Слишком большой файл модели: файл model_url превышает 400 МБ при загрузке по URL с http или https, либо превышает 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 МБ, и его заголовок содержит слишком много сеток, узлов или записей для проверки. Уменьшите количество объектов в файле, затем отправьте его снова.
• Слишком большое изображение: изображение image_style_url или одно из изображений multiview_image_urls превышает 20 МБ.

При использовании meshy-n1 модель, которую Meshy не может проверить до начала задачи, например файл STL, не отклоняется на этом этапе. Если она содержит более 7 999 999 треугольников, задача завершается с ошибкой, а Meshy возвращает потраченные кредиты.

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

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

Например:

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

Применимо одно из следующего:

• Модерация контента заблокировала prompt или входное изображение. Измените входные данные, затем повторите попытку.
• 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 задачи. Рассматривайте его как непрозрачную строку и не полагайтесь на её формат.

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

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

Текстовый prompt, с которым вы создали задачу.

Изображение стиля, с которым вы создали задачу.

Ссылки для скачивания референсных изображений Мультивид, с которыми вы создали задачу. Присутствует только если вы создали задачу с multiview_image_urls.

Ссылка для скачивания миниатюры модели.

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

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

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

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

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

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

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

Ссылки для скачивания сгенерированных текстур в виде массива объектов. Обычно массив содержит один объект. Каждый объект имеет следующие поля:

Количество задач впереди этой в очереди. Присутствует только пока задача находится в статусе PENDING; поле отсутствует, если значение равно 0.

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

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