# Meshy 6 Retexture API

> Meshy 6 Retexture repaints an existing 3D model from a text or image style, with optional PBR maps and up to 8K textures.

Source: https://www.sandbase.ai/models/meshy/6.0/retexture
API reference: https://www.sandbase.ai/models/meshy/6.0/retexture/docs

## Facts

- Provider: Meshy
- Type: Image model
- Model ID: `meshy/6.0/retexture`
- Price: From $0.33 per run
- Capabilities: 3d 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/6.0/retexture",
  "model_url": "https://v3b.fal.media/files/b/penguin/DId89qXLu6BXu09RFAwAV_model.glb",
  "enable_pbr": false,
  "text_style_prompt": "red and black chest",
  "enable_original_uv": true,
  "texture_resolution": "2k"
}'
```

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 6 Retexture through SandBase?

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

## README

### Meshy 6 Retexture
Meshy 6 Retexture repaints an existing 3D model from a text or image style, with optional PBR maps and up to 8K textures.
#### Fields
| Field | Type | Default | Notes |
|---|---|---|---|
| `model_url` | 3D model URL, required | — | .glb, .gltf, .obj, .fbx or .stl. |
| `text_style_prompt` | string | — | Texture style, up to 600 characters. Required when `image_style_url` is not set. |
| `image_style_url` | image URL | — | JPG or PNG style reference; takes precedence over the text prompt. |
| `texture_resolution` | `2k` / `4k` / `8k` | `2k` | Base color resolution; 8k costs more and its PBR maps are 4k. |
| `enable_pbr` | boolean | false | Also generate metallic, roughness and normal maps. |
| `enable_original_uv` | boolean | true | Keep the model's UV layout. |
#### Billing
$0.33 per retextured model at 2k or 4k, $0.50 at 8k; PBR maps are included.
| Request | Price |
|---|---|
| 2k (default) | $0.33 |
| 4k + PBR | $0.33 |
| 8k | $0.50 |
Failed runs are not charged.
#### Prompting
- Name materials and finish, e.g. "weathered bronze with green patina".
- Provide either `text_style_prompt` or `image_style_url`.
#### Also on SandBase
Other retexture models: `meshy/7.0/retexture`, `meshy/6.0-lite/retexture`.