# Meshy Relief API

> Meshy Relief turns a photo into a printable 3D relief (GLB and STL) with emboss or engrave carving and an optional curved bend.

Source: https://www.sandbase.ai/models/meshy/relief
API reference: https://www.sandbase.ai/models/meshy/relief#api

## Facts

- Provider: Meshy
- Type: Image model
- Model ID: `meshy/relief`
- Price: $0.80 per run
- Capabilities: image to 3d
- Billing: pay per use from one SandBase balance; no provider account or subscription needed

## Call it

- Unified Run API: `POST https://api.sandbase.ai/v1/run`

```bash
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "meshy/relief",
  "image": "https://static.sandbase.ai/examples/meshy/relief/input_image_0.png",
  "size_mm": 60,
  "variant": "low",
  "bend_axis": "xz",
  "bend_mode": "off",
  "bend_angle": 60,
  "remove_base": false,
  "carving_mode": "emboss",
  "mesh_resolution": 1024
}'
```

The response returns a run id; poll `GET https://api.sandbase.ai/v1/run/{id}` until the status is `completed` or `failed`.

## FAQ

### How do I call Meshy Relief through SandBase?

Create a SandBase API key, then send requests with the model ID "meshy/relief" to Unified Run API (/v1/run) at https://api.sandbase.ai. The request examples on this page show the exact payload.

### Do I need a separate Meshy account?

No. One SandBase API key and balance gives you access to Meshy Relief and the other models in the catalog; you do not need to sign up with Meshy separately.

## README

### Meshy Relief
Meshy Relief turns a photo into a printable 3D relief (GLB and STL) with emboss or engrave carving and an optional curved bend.
#### Fields
| Field | Type | Default | Notes |
|---|---|---|---|
| `image` | image URL, required | — | Photo to turn into a relief. Works best with one clear subject on a plain background. JPG, PNG or WebP up to 20 MB. |
| `variant` | `low` / `high` | `low` | 'low' gives slight depth and finer detail (patterns, badges, seals); 'high' gives bold, sculptural depth (pets, portraits, characters). |
| `carving_mode` | `emboss` / `engrave` | `emboss` | 'emboss' makes nearer parts stand out; 'engrave' cuts them in. |
| `size_mm` | number 20–250 | `60` | Length of the photo's long side in millimeters, measured flat before any bend. |
| `carving_depth_mm` | number 0–60 | — | Carving depth in millimeters. Defaults to 3 for 'low' and 6 for 'high'. |
| `base_thickness_mm` | number 0.1–10 | — | Base plate thickness in millimeters (default 1). Not allowed with remove_base. |
| `remove_base` | boolean | `false` | Cut away the background and build no base plate. |
| `bend_mode` | `off` / `convex` / `concave` | `off` | Bend the relief into a convex or concave curve. |
| `bend_axis` | `xz` / `yz` | `xz` | 'xz' curls the left and right edges, 'yz' the top and bottom. |
| `bend_angle` | number 0–360 | `60` | Bend angle in degrees when bending is on. |
| `mesh_resolution` | integer 512–2048 | `1024` | Mesh points along the long side. At 2048 the GLB reaches about 150 MB and the STL about 300 MB. |
#### Output
- `url`: Main 3D file (GLB unless another export format is selected).
- `thumbnail`: Preview image rendered by the provider.
- `stl`: Additional file returned by the provider.
- `depth_map`: Additional file returned by the provider.
#### Billing
$0.80 per request.
Failed runs are not charged.
#### Also on SandBase
Other Meshy 3D endpoints: `meshy/6.0-lite/retexture`, `meshy/6.0/retexture`, `meshy/7.0/image-to-3d`, `meshy/7.0/multi-image-to-3d`.