Retexture API

ID завершённой задачи Изображение в 3D или Текст в 3D, которую вы хотите ретекстурировать. Эта задача должна быть одной из следующих: Text to 3D Preview, Text to 3D Refine, Image to 3D или Remesh. Кроме того, она должна иметь статус SUCCEEDED.

Предоставьте 3D-модель для текстурирования Meshy. Поддерживаемые форматы: .glb, .gltf, .obj, .fbx, .stl.

Максимальный размер файла: 400 МБ для URL http или https, 100 МБ для data: URI.

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

Существует два способа предоставить модель:

• Публично доступный URL: URL, доступный из публичного интернета.
• Data URI: закодированный в base64 data URI модели. Используйте MIME type application/octet-stream. Пример: data:application/octet-stream;base64,<ваши закодированные в base64 данные модели>.

Опишите желаемый стиль текстуры объекта с помощью текста. Максимум 800 символов.

Предоставьте 2D-изображение для направления процесса текстурирования. В настоящее время поддерживаются форматы .jpg, .jpeg, .png и .webp.

Максимальный размер файла: 20 МБ.

Существует два способа предоставить изображение:

• Публично доступный URL: URL, доступный из публичного интернета
• Data URI: закодированный в base64 data URI изображения. Пример data URI: data:image/jpeg;base64,<ваши закодированные в base64 данные изображения>

Предоставьте от 1 до 4 изображений, показывающих один и тот же объект с разных ракурсов, для направления текстурирования. Первое изображение является основным (вид спереди); порядок остальных ракурсов (слева, сзади, справа) не имеет значения.

Каждый элемент поддерживает те же форматы, что и image_style_url (публично доступный URL или base64 data URI, .jpg/.jpeg/.png/.webp).

Максимальный размер файла: 20 МБ на изображение.

ID AI-модели, используемой для ретекстурирования. Доступные значения: meshy-6-lite, meshy-6, meshy-7, latest (Meshy 7).

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

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

Генерировать PBR-карты (металличность, шероховатость, нормали) в дополнение к базовому цвету. Карта свечения (emission) также включается, когда ai_model имеет значение meshy-6, за исключением случая texture_resolution: 8k. meshy-6-lite, meshy-7 и latest не создают карту свечения.

Разрешение текстуры базового цвета. Одно из значений: 2k (2048×2048), 4k (4096×4096) или 8k (8192×8192). Более высокое разрешение передаёт больше деталей поверхности.

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

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

Указывает, какие форматы 3D-файлов включить в результат. Будут сгенерированы и возвращены только запрошенные форматы, что может сократить время выполнения задачи. Если параметр не указан, включаются все поддерживаемые форматы.

Доступные значения: glb, obj, fbx, stl, usdz, 3mf

Если установлено значение true, задача дополнительно рендерит версию превью с прозрачным фоном (RGBA) и возвращает её как alpha_thumbnail_url в ответе GET. Существующее поле 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".
• Модель недоступна: ai_model: "meshy-7" и ai_model: "meshy-6-lite" внедряются постепенно и могут быть ещё не включены для вашего аккаунта.
• Недопустимая входная задача: input_task_id должен ссылаться на успешную задачу от поддерживаемой модели.
• Недопустимый формат модели: model_url указывает на файл с неподдерживаемым расширением.
• Недоступный URL: не удалось загрузить 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 МБ, и его заголовок не удаётся прочитать, например, сжатый с помощью Draco GLB или glTF, либо бинарный FBX старше версии 7.1.
• Слишком сложный заголовок модели: файл model_url превышает 100 МБ, и его заголовок содержит слишком много сеток, узлов или записей для проверки. Уменьшите количество объектов в файле и отправьте его снова.
• Изображение слишком большое: изображение image_style_url или элемент multiview_image_urls превышает 20 МБ.

Ошибка аутентификации. Пожалуйста, проверьте свой API-ключ.

Недостаточно кредитов для выполнения этой задачи.

Вы превысили ограничение частоты запросов.

Уникальный идентификатор задачи Ретекстурирования, которую требуется получить.

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

Номер страницы для пагинации.

Ограничение размера страницы. Максимально допустимое значение — 100 элементов.

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

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

• +created_at: Сортировка по времени создания в порядке возрастания.
• -created_at: Сортировка по времени создания в порядке убывания.

Уникальный идентификатор задачи ретекстурирования для потоковой передачи.

Уникальный идентификатор задачи. Хотя в качестве деталей реализации мы используем k-sortable UUID для идентификаторов задач, вам не следует делать никаких предположений о формате id.

Тип задачи Ретекстурирования. Значение — retexture.

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

Это текстовый prompt, использованный для создания задачи текстурирования.

Это изображение, использованное для создания задачи текстурирования.

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

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

Ссылка для скачивания версии thumbnail_url с прозрачным фоном (RGBA). Присутствует только если задача была создана с alpha_thumbnail: true и прозрачный предпросмотр был успешно сгенерирован; в противном случае это поле отсутствует.

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

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

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

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

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

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

Массив объектов URL текстур, сгенерированных задачей. Обычно он содержит только один объект URL текстуры. Каждый объект URL текстуры имеет следующие свойства:

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

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

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