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 МБ з http- або https-URL, або 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.

ШІ-модель, що генерує текстуру.

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

• 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 також генерує карту випромінювання (emission), окрім 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 МБ з 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 МБ, і його заголовок містить забагато сіток, вузлів або записів для перевірки. Зменшіть кількість об'єктів у файлі, потім надішліть його знову.
• Зображення завелике: зображення 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.

URL-адреси для завантаження текстурованої 3D-моделі, по одній на кожен формат файлу.

Текстовий prompt, з яким ви створили завдання.

Зображення стилю, з яким ви створили завдання.

URL-адреси для завантаження референсних зображень з кількох ракурсів, з якими ви створили завдання. Присутнє лише тоді, коли ви створили завдання з multiview_image_urls.

URL-адреса для завантаження мініатюри моделі.

URL-адреса для завантаження версії thumbnail_url з прозорим фоном (RGBA). Присутнє лише тоді, коли ви створили завдання з alpha_thumbnail: true і Meshy відобразив прозорий попередній перегляд.

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

Час початку завдання в мілісекундах Unix. Значення 0, поки завдання не почалося.

Час створення завдання в мілісекундах Unix.

Час закінчення терміну дії результатів завдання в мілісекундах Unix.

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

Статус завдання, один із PENDING, IN_PROGRESS, SUCCEEDED, FAILED або CANCELED.

URL-адреси для завантаження згенерованих текстур, у вигляді масиву об'єктів. Зазвичай масив містить один об'єкт. Кожен об'єкт має такі поля:

Кількість завдань попереду цього в черзі. Присутнє лише поки завдання має статус PENDING; поле опускається, коли значення дорівнює 0.

Деталі помилки, коли завдання завершується невдало. Див. Помилки.

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