Введение
Meshy N1 создаёт цвет непосредственно на поверхности 3D-объекта. Retexture принимает готовую сетку и изображения-образцы, заменяет текстуру и возвращает GLB с той же формой и числом граней. Фотографии предмета помогают воспроизвести его внешний вид, а изображение стиля — подобрать другую палитру. Работа в 3D уменьшает двоение контуров, растекание цвета и разрывы узоров, возникающие при проецировании отдельных ракурсов.
Ключевые возможности и особенности
Кожаные детали на белом ботинке
Фронтальное фото придало ботинку без текстуры и UV вид потёртой коричневой кожи, швы, красные шнурки и люверсы цвета латуни. Протектор подошвы стал тёмно-коричневым. Через 35 секунд получен GLB размером 3,5 МБ с одной PNG-текстурой на 2048 пикселей и прежними 2 804 треугольниками. Отдельные карты PBR в результат не входят.
Другая палитра на том же ботинке
Белый с оранжевым игрушечный астронавт при отключённом сохранении UV дал ботинку белый верх, серо-синий носок, тёмно-синие шнурки и небольшие оранжевые отметки. Появились узоры, напоминающие панели скафандра. Тест занял 28 секунд; GLB весил 2,6 МБ и по-прежнему содержал 2 804 треугольника.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
mesh_url | Да | Сетка до 90 МБ: GLB, двоичный FBX, OBJ или STL. Прямая ссылка должна заканчиваться соответствующим расширением; JSON .gltf экспортируйте в .glb. Не менее 1 символов |
reference_image_urls | Нет | От 1 до 4 фотографий или рендеров того же предмета, фронтальный вид первым. Укажите это поле либо |
reference_image_url | Нет | Одно изображение стиля для палитры, вида материала и отметок. Считается фронтальным образцом и заменяет |
keep_original_uv | Нет | По умолчанию включено: сохраняет исходные UV. Выключите для новой развёртки; при отсутствии UV они создаются с любым значением. По умолчанию: |
Стоимость
$0.48 / результат
За каждый успешно выданный результат взимается фиксированная плата, независимо от размера модели, числа образцов и keep_original_uv. Неудачные запросы не оплачиваются, в том числе при неверном формате или отсутствии образцов.
Сценарии использования
Несколько расцветок одного реквизита
Попробуйте разные цвета и узоры на игровом предмете или реквизите для AR, сохранив сетку. Сравните варианты в нужной сцене и осмотрите с разных сторон: образец меняет внешний вид поверхности, а силуэт остаётся прежним.
Цвет для белой модели
Раскрасьте белую модель или цифровую заготовку для 3D-печати и оцените будущую отделку в GLB. Для интернет-магазина можно проверить несколько палитр на готовой модели товара, затем осмотреть все стороны перед показом покупателям.
Руководство по промптам и практические советы
Подготовьте готовую сетку
Загрузите через mesh_url GLB, двоичный FBX, OBJ или STL размером до 90 МБ либо укажите прямую ссылку с окончанием .glb, .fbx, .obj или .stl. Файл JSON .gltf сначала экспортируйте в .glb. Meshy указывает предел в 7 999 999 граней. Если модели ещё нет, её можно получить из изображения с помощью Tripo P1, Tripo H3.1 или Seed3D 2.0.
Выберите один способ передачи образцов
В reference_image_urls передайте от 1 до 4 фотографий или рендеров именно этого предмета, поставив фронтальный вид первым. Другой вариант — одно изображение стиля в reference_image_url для палитры, вида материала и отметок; оно считается фронтальным. Если заполнить оба поля или оставить оба пустыми, запрос будет отклонён без оплаты. Текстовый промпт не требуется.
Настройте UV и проверьте результат
Оставьте keep_original_uv в значении true, чтобы использовать исходную UV-развёртку, или выберите false для новой. Если UV нет, они создаются при любом из двух значений. Поверните полученный GLB и проверьте стыки, нижнюю сторону и расположение цветов.
Быстрый старт API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "meshy/n1/retexture",
"input": {
"mesh_url": "https://example.com/reference.png"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.







