Skip to main content

meshy/relief/image-to-3d

Meshy Relief turns one photo into an embossed or engraved plaque for 3D printing or CNC carving, returning an untextured GLB, an STL and a 16-bit depth map, with size and carving depth set in millimeters.

From $0.96/request

Workbench

Input

Image to 3D
1/1

Drop files or media links, paste, or browse · 1 file · Max 10 MB · JPG · PNG · WEBP

  • 1
1 / 1 files
Required JPEG, PNG or WebP photo, at least 32 x 32 pixels and at most 20 MB; no image is supplied by default. A clear subject and simple background help; the input does not change the fixed rate. at least 1 characters
Safety checkerOff

SpicyAPI does not run a safety checker on this model. Your prompt and media go to the model as written, and the model itself decides what comes back.

Checking your account before enabling submission and pricing.

Output

Ready for a new run
Loading 3D model…
Example result

Missing the model you need?

MESHY PHOTO RELIEF API

Turn a photograph into a relief plaque with millimeter-scale controls.

Key numbers

Preview, print and carve
3 files
Each successful task delivers a GLB, an STL and a depth PNG.
Grayscale depth
16-bit
Brighter areas of the depth PNG represent greater relief height.
Longest side
20–250mm
Set the long dimension of the photograph on the model, measured flat before bending.
Carving depth
0–60 mm
An optional depth value overrides the low or high preset.
Mesh sampling
512–1024
Choose the number of mesh points along the long dimension.
Flat price per run
1 rate
Changes to relief depth, size, mesh sampling and bending do not add charges.

Before you spend

All modes

Relief files are stored for 14 days, after which they are deleted.

Image to 3D
  • The result is relief geometry on a plaque with a flat back in the unbent form, not a complete object reconstructed from all directions.
  • Background removal depends on depth separation; our oak sample retained its plate with remove_base enabled and removal_threshold at 0.05.
  • Returned meshes have no textures; large GLB files can take time to load in the preview.

What it does

Render of a relief plaque showing a woman in profile holding a silk sheet, with carved hair strands and fabric folds.

Profile in depth

Hair and silk become carved detail

A profile photo became a relief plaque with default settings in our new sample. The render shows separate hair strands and folds in the silk as depth, with GLB, STL and a 16-bit depth map delivered together. This is a view of the generated geometry; it does not show a physical print.

A white tabby-cat portrait appears in relief on a plaque with a flat back.

Pet plaque files

A cat portrait ready for slicing

The cat sample returned a 40 MB GLB and an 85 MB STL at mesh_resolution 1024, together with its depth PNG. Open the GLB to examine the relief, then use the STL in your printing workflow; a preview this large can take time to load.

Removal in practice

Oak detail with the plate still present

A rendered white square plaque carries an engraved oak branch with three leaves and two acorns, with the back plate still present.

Our 120 mm oak test combined engrave, high and remove_base with a 0.05 threshold. Leaves and acorns appeared clearly, but the base remained. Raising the threshold cuts away more background; the result depends on the depth gap between the subject and its surroundings.

Made with Meshy Relief

  • Generated relief from a profile photo at default settings; GLB, STL and a 16-bit depth map were returned. The image shows a render, not a physical print.
  • A rendered white square plaque carries an engraved oak branch with three leaves and two acorns, with the back plate still present.
  • Grayscale depth map of a tabby cat head: the nose and muzzle are brightest, the ears and fur edges fade to darker gray, the background is black.
    The 16-bit depth map returned with the cat relief; brighter means raised.
  • Front view of a square white relief plate carved with an oak branch, three lobed leaves with veins and two acorns.
    Render of the returned GLB: engrave, high, 120 mm.

Where it fits

  • Portrait keepsakes with fabric detail

    Use a profile photograph for a commemorative plaque. Our silk portrait sample turned hair strands and fabric folds into visible depth with the default settings.

  • Pet photographs for printed plaques

    Take a pet photo through to an STL for slicing. The tested cat relief returned a 40 MB GLB and 85 MB STL at mesh_resolution 1024, so allow time for file handling.

  • Depth maps for CNC carving

    Bring the supplied 16-bit grayscale PNG into a relief-carving workflow. Its bright areas represent raised detail, giving you a height reference alongside the mesh files.

  • Engraved botanical panels

    Prepare decorative designs with engrave mode and a chosen physical size. Our 120 mm oak run showed clear leaves and acorns, while also showing why a removal request needs visual review.

  • Curved badges and display pieces

    Shape a relief with convex or concave bending and select which pair of edges curls. A tested 100 mm portrait at convex 90 degrees showed a visible curve, with hair and clothing detail retained.

Model reference

Meshy Relief API reference

Meshy Relief API specifications

Input photograph
One image_url; JPEG, PNG or WebP; at least 32 x 32 pixels; up to 20 MB
Delivered files
Untextured GLB, STL and 16-bit grayscale depth PNG
Relief presets
relief_height: low (default, approximately 3 mm) or high (approximately 6 mm)
Carving direction
carving_mode: emboss (default) or engrave
Depth override
carving_depth_mm: 0–60 mm; omitted uses the preset depth
Physical long side
size_mm: 20–250 mm; default 60 mm, measured flat before bending
Base thickness
base_thickness_mm: 0.1–10 mm; omit with remove_base enabled
Background removal
remove_base: off by default; removal_threshold: 0.01–1, default 0.01; higher removes more
Curvature controls
bend_mode: off (default), convex or concave; bend_axis: xz (default) or yz; bend_angle: 0–360 degrees, default 60
Mesh sampling
mesh_resolution: 512–1024 points along the long side; default 1024
Measured completion time
Default-setting tests: 56–76 seconds; preview loading takes additional time
Charge per relief
Fixed for every supported setting; failed tasks are not charged

How to call the Meshy Relief API

  1. Prepare the source photograph

    Choose a JPEG, PNG or WebP with a clear subject and simple background, at least 32 x 32 pixels and up to 20 MB. For portraits, use photos you have the right to use, feature adults only and avoid impersonation.

  2. Set size and carving direction

    Enter image_url and choose emboss or engrave, then set size_mm for a 20–250 mm long side. Leave relief_height at low, choose high, or set carving_depth_mm to override the preset depth.

  3. Decide on the plate and curve

    Keep the base or request remove_base, omitting base_thickness_mm when removal is enabled. For curvature, select a bend mode and axis, then set the angle; background removal may still leave part of the plate.

  4. Inspect and download the files

    Allow large GLB files time to load, then inspect the relief from several angles. Download the STL for slicing or the depth PNG for carving, and check the dimensions in your destination software.

The short version

Choose the source photo for the detail you want to see in relief: a readable profile, distinct pet features or clearly separated leaves. Start with the default plaque or set its size, carving direction and depth for your design, then inspect the GLB before moving to the STL or 16-bit depth PNG. Our samples show hair, fabric and botanical detail, alongside a case where background removal left the plate in place. Allow time for large files to load and confirm the imported dimensions before printing or carving.

Meshy Relief API questions

All Meshy models2