Introducción
El endpoint de foto a relieve crea una placa a partir de una imagen proporcionada, con controles de dirección de tallado, dimensiones en milímetros, eliminación del fondo y curvatura.
| Campo | Valor |
|---|---|
| Entrada | Imagen |
| Salida | Modelo 3D |
| Foto de entrada | Una |
| Archivos entregados | GLB sin texturas, STL y PNG de profundidad en escala de grises de 16 bits |
| Ajustes de relieve |
|
| Dirección del tallado |
|
| Profundidad personalizada |
|
| Lado largo físico |
|
| Grosor de base |
|
| Eliminación del fondo |
|
| Controles de curvatura |
|
| Muestreo de malla |
|
| Tiempo de finalización medido | Pruebas predeterminadas: 56–76 segundos; cargar la vista previa requiere tiempo adicional |
| Cargo por relieve | Fijo con cualquier ajuste admitido; las tareas fallidas no se cobran |
Funciones y aspectos destacados
Cabello y seda se convierten en detalles tallados
Una foto de perfil se convirtió en placa con los ajustes predeterminados. El render muestra mechones separados y pliegues de seda como profundidad; se entregaron GLB, STL y mapa de 16 bits. Es una vista de la geometría generada y no una impresión física.
Un retrato de gato listo para laminar
El gato devolvió un GLB de 40 MB y STL de 85 MB con mesh_resolution 1024, además de su PNG de profundidad. Abre GLB para examinar el relieve y usa STL para imprimir; una vista previa tan grande puede tardar en cargar.
Detalle de roble con la placa aún presente
La prueba de roble de 120 mm combinó engrave, high y remove_base con umbral 0,05. Hojas y bellotas se distinguieron claramente, pero quedó la base. Aumentar el umbral elimina más fondo; el resultado depende de la diferencia de profundidad entre sujeto y entorno.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
image_url | Sí | Foto obligatoria JPEG, PNG o WebP de al menos 32 x 32 píxeles y como máximo 20 MB; no hay imagen predeterminada. mínimo 1 caracteres |
relief_height | No | Elige low (predeterminado, unos 3 mm de profundidad) o high (unos 6 mm); |
carving_mode | No | emboss es el valor predeterminado y eleva el sujeto sobre la placa; engrave talla hacia adentro las partes más cercanas. Ambos modos tienen el mismo precio. |
carving_depth_mm | No | Ajuste directo opcional de profundidad de 0 a 60 mm; si lo omites, |
size_mm | No | Dimensión larga de la fotografía sobre el relieve, medida en plano antes de curvar: 20–250 mm, con 60 mm por defecto. El tamaño físico no modifica el cargo. |
base_thickness_mm | No | Grosor opcional de la placa de 0.1–10 mm; aquí no se especifica un valor numérico predeterminado. Omítelo si activas |
remove_base | No | Desactivado por defecto; actívalo para solicitar la eliminación del fondo y la placa, conservando el sujeto. Valor predeterminado: |
removal_threshold | No | Umbral de eliminación del fondo de 0.01 a 1, con 0.01 por defecto; actúa cuando |
bend_mode | No | off (predeterminado) mantiene la placa plana; convex curva hacia afuera y concave hacia adentro. El modo de curvatura no agrega cargos. |
bend_axis | No | xz (predeterminado) curva los lados izquierdo y derecho; yz curva los bordes superior e inferior. El eje tiene efecto al activar la curvatura y no influye en el cobro. |
bend_angle | No | Ángulo de curvatura en grados, de 0 a 360 y con 60 por defecto; úsalo con el modo convex o concave. El ángulo elegido no afecta el costo. |
mesh_resolution | No | Cantidad de puntos de la malla a lo largo de la dimensión mayor: 512–1024, con 1024 por defecto. |
Precios
$0.96 / relieve
Cada relieve completado tiene un cargo fijo; incluye todos los ajustes admitidos y los fallos no se cobran.
Casos de uso
Recuerdos de retrato con detalle de tela
Usa una foto de perfil para una placa conmemorativa. La muestra de seda transformó mechones y pliegues en profundidad visible con los ajustes predeterminados.
Placas impresas de mascotas
Convierte la foto de una mascota en STL para laminar. El gato probado devolvió un GLB de 40 MB y STL de 85 MB con mesh_resolution 1024: reserva tiempo para manejar los archivos.
Mapas de profundidad para CNC
Incorpora el PNG de 16 bits en escala de grises al proceso de tallado en relieve. Las zonas claras representan mayor altura y aportan una referencia junto a las mallas.
Paneles botánicos grabados
Prepara diseños decorativos con engrave y un tamaño físico elegido. El roble de 120 mm mostró hojas y bellotas claras y evidenció por qué hay que revisar visualmente una solicitud de eliminación.
Insignias y piezas de exhibición curvas
Da forma al relieve con convex o concave y selecciona qué par de bordes curvar. El retrato de 100 mm probado con convex a 90 grados mostró curvatura visible y conservó detalles de cabello y ropa.
Guía de prompts y consejos prácticos
Prepara la fotografía de origen
Elige JPEG, PNG o WebP con sujeto claro y fondo sencillo, de al menos 32 x 32 píxeles y hasta 20 MB. Para retratos, usa fotos autorizadas, solo de personas adultas y sin suplantación.
Fija tamaño y dirección del tallado
Introduce
image_urly elige emboss o engrave; configurasize_mmpara un lado largo de 20–250 mm. Conservarelief_heighten low, elige high o usacarving_depth_mmpara reemplazar la profundidad predefinida.Decide sobre placa y curvatura
Conserva la base o solicita
remove_basey omitebase_thickness_mmal activar la eliminación. Para curvar, selecciona modo, eje y ángulo; la eliminación de fondo puede dejar parte de la placa.Inspecciona y descarga los archivos
Da tiempo a cargar los GLB grandes y revisa el relieve desde varios ángulos. Descarga STL para el laminado o PNG de profundidad para tallado y comprueba las dimensiones en el programa de destino.
De foto a relieve: elige la imagen de origen
Meshy Relief convierte una fotografía en una placa con detalles elevados o hundidos. Usa imagen a 3D para un recuerdo de retrato, una placa de mascota, una insignia o un panel decorativo tallado. Sin curvar, la placa tiene respaldo plano y la geometría entregada carece de texturas.
La entrada es image_url, no una escena escrita. Escoge un sujeto claro ante fondo sencillo; JPEG, PNG y WebP deben medir al menos 32 x 32 píxeles y no superar 20 MB. Para fotos de personas, usa imágenes autorizadas, solo de adultos y sin suplantación.
Controles de profundidad, tamaño y curvatura
| Parámetro | Rango u opciones | Valor predeterminado y propósito |
|---|---|---|
image_url | Un JPEG, PNG o WebP; hasta 20 MB; al menos 32 x 32 píxeles | Foto de origen obligatoria |
relief_height | low, high | low; unos 3 mm de profundidad, o unos 6 mm con high |
carving_mode | emboss, engrave | emboss eleva el sujeto; engrave talla hacia adentro las partes más cercanas |
carving_depth_mm | 0–60 mm | Opcional; reemplaza la profundidad predefinida |
size_mm | 20–250 mm | 60 mm; lado largo de la foto, medido en plano antes de curvar |
base_thickness_mm | 0,1–10 mm | Grosor opcional; omitir al activar remove_base |
remove_base | true, false | false; solicita eliminar fondo y placa |
removal_threshold | 0,01–1 | 0,01; un valor mayor elimina más fondo al activar la eliminación |
bend_mode | off, convex, concave | off; convex curva hacia afuera, concave hacia adentro |
bend_axis | xz, yz | xz curva izquierda y derecha; yz, arriba y abajo |
bend_angle | 0–360 grados | 60; se utiliza con un modo curvado |
mesh_resolution | 512–1024 | 1024 puntos de malla a lo largo del lado mayor |
Configura dimensiones físicas y muestreo por separado. size_mm describe la extensión prevista de la foto en el modelo; mesh_resolution controla la densidad del muestreo. Reducirla crea archivos menores con menos detalle. carving_depth_mm reemplaza la profundidad predefinida; al omitirlo se utiliza la aproximada de low o high.
Solicita un sujeto separado
Activa remove_base para obtener el sujeto sin placa y omite base_thickness_mm en esa solicitud. La eliminación depende de la diferencia de profundidad entre sujeto y fondo. Un removal_threshold mayor recorta más, pero activar el interruptor no confirma que desaparezca la placa. Revisa contorno y respaldo en el modelo recibido.
Tres archivos para etapas diferentes
- GLB: gira el relieve sin texturas para examinar forma y curvatura.
- STL: lleva la geometría al laminador para imprimir.
- PNG de profundidad: usa la imagen de 16 bits en escala de grises para CNC o tallado; las zonas claras representan más altura.
Meshy indica que GLB usa metros y STL milímetros. Si la escala importada resulta inesperada, revisa las unidades del programa y compara dimensiones con el tamaño solicitado. Este se mide antes de curvar: no equivale a la anchura de la placa curvada.
Prepara descripciones y fotografías de origen
De foto a relieve no tiene campo prompt. Los ejemplos de prompt de la página sirven para preparar una fotografía, no para enviarlos a este endpoint. Al planearla, describe persona u objeto, ropa o material, ambiente, luz y entorno; después envía la URL de la imagen terminada.
Un encargo de retrato puede pedir una persona adulta de unos treinta años con bata de seda, expresión serena, luz suave de estudio y fondo liso. Busca pliegues visibles y cabello separado, sin elementos que distraigan. Para un panel botánico, mantén hojas y bellotas claras contra un fondo sencillo. Son sugerencias de composición de entrada, sin resultados medidos para cada escena.
Qué mostraron las muestras
La nueva muestra de perfil con seda usó valores predeterminados y entregó una placa con mechones y pliegues tallados en profundidad, junto con los tres archivos. La imagen mostrada es un render de geometría; no demuestra una impresión física terminada.
Con mesh_resolution 1024, el gato devolvió GLB de 40 MB y STL de 85 MB. El roble de 120 mm produjo GLB de 100 MB y STL de 150 MB: hojas y bellotas claras, pero conservó la placa pese a high, engrave y remove_base con umbral 0,05. Por eso debe revisarse visualmente la eliminación.
Otra prueba de retrato combinó high, engrave, 100 mm y curvatura convex a 90 grados. Terminó en 69 segundos con curva visible y detalle claro de cabello y ropa. Las ejecuciones predeterminadas tardaron 56–76 segundos en las pruebas. Estos tiempos corresponden a esas ejecuciones; cargar una vista previa GLB grande añade tiempo.
Precio y elección de otro modelo
Cada relieve completado tiene cargo fijo. Tamaño, profundidad, muestreo, eliminación y curvatura no modifican la tarifa y las tareas fallidas no se cobran. Consulta el precio vigente en la página de Meshy Relief antes de enviar.
Usa Relief para placas con detalle en una cara. Para un objeto completo, considera Seed3D 2.0 o Tripo H3.1. Antes de fabricar, revisa la forma, comprueba el fondo eliminado y confirma las dimensiones en tu programa de impresión o tallado.
Inicio rápido de la 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"
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.






