# Meshy 7.1 Image to 3D API

> Meshy 7.1 turns a single image into a textured, optionally rigged and animated 3D model.

Source: https://www.sandbase.ai/models/meshy/7.1/image-to-3d
API reference: https://www.sandbase.ai/models/meshy/7.1/image-to-3d/docs

## Facts

- Provider: Meshy
- Type: Image model
- Model ID: `meshy/7.1/image-to-3d`
- Price: From $1.44 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/7.1/image-to-3d",
  "image": "https://v3b.fal.media/files/b/zebra/3osHJDI8IZ2wl6sGtEUeB_image.png",
  "topology": "triangle",
  "enable_pbr": false,
  "model_type": "standard",
  "symmetry_mode": "auto",
  "enable_rigging": false,
  "should_texture": true,
  "enable_animation": false,
  "target_polycount": 30000,
  "geometry_resolution": "standard"
}'
```

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 7.1 Image to 3D through SandBase?

Create a SandBase API key, then send requests with the model ID "meshy/7.1/image-to-3d" 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 7.1 Image to 3D and the other models in the catalog; you do not need to sign up with Meshy separately.

## README

### Meshy 7.1 Image to 3D

Meshy 7.1 turns a single image into a textured 3D model, optionally rigged and animated.

#### Fields

| Field | Type | Default | Notes |
|---|---|---|---|
| `image` | image URL, required | — | Image URL or base64 data URI for 3D model creation. |
| `symmetry_mode` | `off` / `auto` / `on` | `auto` | Enforce symmetry. |
| `enable_rigging` | boolean | false | Add a humanoid rig. |
| `model_type` | `standard` / `lowpoly` / `smart-topology` | `standard` | Mesh style. |
| `enable_pbr` | boolean | false | PBR texture maps. |
| `pose_mode` | `a-pose` / `t-pose` / `` | — | Force an A- or T-pose. |
| `should_texture` | boolean | true | Generate textures; untextured costs less. |
| `enable_animation` | boolean | false | Add a walk/run animation (requires rigging). |
| `texture_prompt` | string | — | Optional texture description. |
| `geometry_resolution` | `standard` / `2k` / `4k` | `standard` | Mesh detail; higher tiers cost more. |
| `target_polycount` | integer 100–300000 | 30000 | Target polygon count. |
| `topology` | `quad` / `triangle` | `triangle` | Quad or triangle mesh. |
| `texture_image` | image URL | — | Optional texture reference image. |

#### Billing

$1.44 per textured model ($0.96 untextured); 2K geometry adds $0.24 and 4K adds $0.48; rigging adds $0.24 and animation another $0.144.

| Request | Price |
|---|---|
| Textured | $1.44 |
| Untextured | $0.96 |
| Textured, 2K geometry | $1.68 |
| Textured + rig + animation | $1.824 |

Failed runs are not charged.

#### Prompting

- Describe or show one object; plain backgrounds work best.

#### Also on SandBase

Other Meshy 7.1 endpoints: `meshy/7.1/text-to-3d`, `meshy/7.1/multi-image-to-3d`.