Введение
Эндпоинт преобразования фото в рельеф создаёт пластину по загруженному изображению; настраиваются направление резьбы, размеры в миллиметрах, удаление фона и изгиб.
| Характеристика | Значение |
|---|---|
| Ввод | Изображение |
| Вывод | 3D-модель |
| Исходная фотография | Один |
| Комплект результата | GLB без текстур, STL и 16-битный PNG глубины в оттенках серого |
| Уровни рельефа |
|
| Направление резьбы |
|
| Прямая глубина |
|
| Физическая длинная сторона |
|
| Толщина основания |
|
| Удаление окружения |
|
| Настройки кривизны |
|
| Плотность сетки |
|
| Замеры завершения | Запуски по умолчанию: 56–76 секунд; загрузка предпросмотра требует времени дополнительно |
| Цена рельефа | Едина для всех доступных настроек; неудачные задачи не оплачиваются |
Ключевые возможности и особенности
Волосы и шёлк становятся резными деталями
Новое фото профиля превратилось в рельефную пластину с настройками по умолчанию. На рендере отдельные пряди и складки шёлка переданы глубиной; вместе выданы GLB, STL и 16-битная карта. Это вид сгенерированной геометрии, а не физической печати.
Кошачий портрет для слайсера
Кот дал GLB 40 МБ и STL 85 МБ при mesh_resolution 1024 вместе с PNG глубины. Осмотрите GLB, затем используйте STL для печати; крупный предпросмотр может загружаться долго.
Дубовые детали на оставшейся пластине
Тест дуба 120 мм сочетал engrave, high и remove_base с порогом 0,05. Листья и жёлуди были чёткими, но основание осталось. Повышение порога удаляет больше фона; результат зависит от перепада глубины.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
image_url | Да | Обязательное фото JPEG, PNG или WebP не меньше 32 x 32 пикселей и не больше 20 МБ; изображения по умолчанию нет. Не менее 1 символов |
relief_height | Нет | Выберите low (по умолчанию, глубина около 3 mm) или high (около 6 mm); |
carving_mode | Нет | Режим emboss по умолчанию поднимает объект над пластиной; engrave вырезает ближние участки внутрь. Цена обоих режимов одинакова. |
carving_depth_mm | Нет | Необязательная глубина от 0 до 60 mm; если не задана, |
size_mm | Нет | Длинная сторона фотографии на рельефе, измеряемая в плоском виде до изгиба: 20–250 mm, по умолчанию 60 mm. Физический размер не меняет цену. |
base_thickness_mm | Нет | Необязательная толщина пластины 0.1–10 mm; числовое значение по умолчанию здесь не указано. Не задавайте при включённом |
remove_base | Нет | По умолчанию выключено; включите для запроса на удаление фона и пластины с сохранением объекта. Успех зависит от разделения по глубине; дополнительной платы нет. По умолчанию: |
removal_threshold | Нет | Порог удаления фона от 0.01 до 1, по умолчанию 0.01; действует при включённом |
bend_mode | Нет | Режим off (по умолчанию) оставляет пластину плоской; convex изгибает наружу, concave — внутрь. Доплаты за режим кривизны нет. |
bend_axis | Нет | Ось xz (по умолчанию) загибает левую и правую стороны; yz — верхнюю и нижнюю. Ось действует при включённом изгибе и не влияет на оплату. |
bend_angle | Нет | Угол изгиба в градусах от 0 до 360, по умолчанию 60; используется с convex или concave. Выбранный угол не влияет на стоимость. |
mesh_resolution | Нет | Число точек сетки вдоль длинной стороны: 512–1024, по умолчанию 1024. Меньшие значения снижают детализацию и размер файла при той же цене за рельеф. |
Стоимость
$0.96 / рельеф
За каждый готовый рельеф взимается одна фиксированная плата; все поддерживаемые настройки включены, сбои не оплачиваются.
Сценарии использования
Памятные портреты с тканью
Профильная фотография подходит для памятной пластины. Наш шёлковый портрет при настройках по умолчанию превратил волосы и складки в видимую глубину.
Печатные пластины с питомцами
Проведите фото питомца до STL для слайсера. Проверенный кот при mesh_resolution 1024 дал GLB 40 МБ и STL 85 МБ: предусмотрите время на файлы.
Карты глубины для CNC
Используйте полученный 16-битный PNG в оттенках серого в рельефной резьбе. Светлые области обозначают поднятые детали, дополняя сетки ориентиром высоты.
Ботанические гравированные панели
Готовьте декор с engrave и нужным физическим размером. Дуб 120 мм показал чёткие листья и жёлуди, а также необходимость визуально проверять удаление.
Изогнутые значки и декор
Используйте convex или concave и выберите пару загибаемых краёв. Портрет 100 мм с convex 90 градусов дал видимый изгиб с сохранением волос и одежды.
Руководство по промптам и практические советы
Подготовьте исходное фото
Выберите JPEG, PNG или WebP с ясным объектом и простым фоном, от 32 x 32 пикселей до 20 МБ. Для портретов используйте разрешённые фотографии совершеннолетних без имитации личности.
Задайте размер и направление резьбы
Введите
image_url, выберите emboss или engrave иsize_mmдля длинной стороны 20–250 мм. Оставьтеrelief_heightlow, выберите high либо переопределите глубину черезcarving_depth_mm.Решите, нужны ли пластина и изгиб
Сохраните основание или задайте
remove_base, исключивbase_thickness_mmпри удалении. Для кривизны выберите режим, ось и угол; удаление фона может оставить часть пластины.Осмотрите и скачайте файлы
Дайте крупному GLB загрузиться, затем рассмотрите рельеф с разных сторон. Скачайте STL для слайсера или PNG глубины для резьбы, проверьте размеры в целевой программе.
Фото в рельеф: выбор исходника
Meshy Relief превращает одну фотографию в пластину с выпуклыми или углублёнными деталями. Используйте image-to-3d для памятного портрета, питомца, значка или декоративной резной панели. До изгиба задняя сторона плоская, выданная геометрия не имеет текстур.
Вход — image_url, а не текстовое описание сцены. Выберите ясный объект на простом фоне; JPEG, PNG и WebP должны быть не менее 32 x 32 пикселей и не более 20 МБ. Если на фото люди, подтвердите право на снимок, совершеннолетие героев и отсутствие имитации чужой личности.
Глубина, размер и кривизна
| Параметр | Диапазон или выбор | Исходное значение и назначение |
|---|---|---|
image_url | Один JPEG, PNG или WebP; до 20 МБ; от 32 x 32 пикселей | Обязательное фото |
relief_height | low, high | low; около 3 мм глубины, high — около 6 мм |
carving_mode | emboss, engrave | emboss поднимает объект; engrave углубляет ближние части |
carving_depth_mm | 0–60 мм | Необязателен; заменяет глубину пресета |
size_mm | 20–250 мм | 60 мм; длинная сторона фото в плоскости до изгиба |
base_thickness_mm | 0,1–10 мм | Необязательная толщина; исключите при remove_base |
remove_base | true, false | false; запрос удаления фона и пластины |
removal_threshold | 0,01–1 | 0,01; повышение удаляет больше фона при включённом удалении |
bend_mode | off, convex, concave | off; convex наружу, concave внутрь |
bend_axis | xz, yz | xz загибает левый и правый края; yz верхний и нижний |
bend_angle | 0–360 градусов | 60; применяется при изгибе |
mesh_resolution | 512–1024 | 1024 точки сетки вдоль длинной стороны |
Физический размер задаётся отдельно от плотности сетки. size_mm описывает протяжённость фото на модели, mesh_resolution — плотность выборки формы. Более редкая сетка уменьшает файлы и детали. carving_depth_mm заменяет глубину пресета; без него используется приблизительная глубина low или high.
Отдельный объект без основания
Включите remove_base для объекта без пластины и не передавайте base_thickness_mm. Удаление зависит от разницы глубин объекта и фона. Повышенный removal_threshold срезает больше фона, но включённая настройка не доказывает исчезновения пластины. Осмотрите контур и заднюю часть результата.
Три файла для разных этапов
- GLB: вращайте рельеф без текстур для оценки формы и изгиба.
- STL: переносите геометрию в слайсер для печати.
- PNG глубины: используйте 16-битные оттенки серого для CNC или рельефной резьбы; светлые области выше.
По данным Meshy, GLB использует метры, STL — миллиметры. При неожиданном масштабе проверьте единицы целевой программы и сравните размеры с запросом. Размер измерен до изгиба, поэтому это не размах изогнутой пластины.
Подготовка описаний и фотографий
В Photo to Relief нет поля prompt. Примеры промптов страницы — задания для подготовки исходной фотографии, а не текст для этого эндпоинта. При планировании фото опишите человека или предмет, одежду либо материал, настроение, свет и место; затем передайте URL готового изображения.
Портретное задание может описывать человека тридцати с лишним лет в шёлковом халате, со спокойным выражением, мягким студийным светом и простым фоном. Ищите различимые складки и пряди вместо лишнего окружения. Для ботанической панели выделите листья и жёлуди на простом фоне. Это советы по композиции входа, а не измеренные результаты каждой сцены.
Что показали примеры
Новый шёлковый профиль с настройками по умолчанию дал пластину с прядями и складками в глубине вместе с тремя файлами. Показанное изображение — рендер геометрии, а не свидетельство готовой физической печати.
При mesh_resolution 1024 кот дал GLB 40 МБ и STL 85 МБ. Дуб 120 мм — GLB 100 МБ и STL 150 МБ; листья и жёлуди были чёткими, но основание осталось при high, engrave, remove_base и пороге 0,05. Поэтому удаление нужно проверять визуально.
Отдельный портрет сочетал high, engrave, 100 мм и convex 90 градусов. Он завершился за 69 секунд с видимой кривизной и чёткими волосами и складками одежды. Запуски по умолчанию заняли 56–76 секунд. Это время конкретных запусков; крупный GLB загружается дополнительно.
Цена и другая модель
Каждый готовый рельеф имеет фиксированную цену. Размер, глубина, сетка, удаление и изгиб её не меняют; ошибки не оплачиваются. Перед запросом смотрите тариф на странице Meshy Relief.
Relief подходит для пластины с деталями с одной стороны. Для целого объекта рассмотрите Seed3D 2.0 или Tripo H3.1. До изготовления оцените форму, удаление фона и размеры в программе печати или резьбы.
Быстрый старт 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/relief/image-to-3d",
"input": {
"bend_axis": "xz",
"bend_mode": "off",
"carving_mode": "emboss",
"image_url": "https://example.com/reference.png",
"relief_height": "low"
}
}'
# 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.






