# Tripo3D Tripo Smart UV API

> Tripo Smart UV unwraps an existing 3D model into a clean UV layout, optionally baking the textures onto it.

Source: https://www.sandbase.ai/models/tripo3d/tripo/smart-uv
API reference: https://www.sandbase.ai/models/tripo3d/tripo/smart-uv#api

## Facts

- Provider: Tripo3D
- Type: Image model
- Model ID: `tripo3d/tripo/smart-uv`
- Price: $0.20 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": "tripo3d/tripo/smart-uv",
  "bake": true,
  "model_url": "https://static.sandbase.ai/examples/tripo3d/tripo/shared/object.glb"
}'
```

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 Tripo3D Tripo Smart UV through SandBase?

Create a SandBase API key, then send requests with the model ID "tripo3d/tripo/smart-uv" 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 Tripo3D account?

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

## README

### Tripo Smart UV
Tripo Smart UV unwraps an existing 3D model into a clean UV layout, optionally baking the textures onto it.
#### Fields
| Field | Type | Default | Notes |
|---|---|---|---|
| `model_url` | string, required | — | URL of the input 3D model, up to 80,000 triangles (a quad counts as 2). |
| `bake` | boolean | `true` | Bake the existing textures onto the new UVs. false returns UVs only. |
| `export_orientation` | `+x` / `-x` / `+y` / `-y` | — | Forward axis of the exported model. Leave unset if you will post-process the model. |
| `compress` | `geometry` | — | geometry applies meshopt compression to reduce file size. |
#### Output
- `url`: GLB with the new UVs.
- `uv_render`: UV atlas preview.
#### Billing
$0.20 per model.
Failed runs are not charged.
