# Idol · Max Turbo

Turn images into 3D models with Idol · Max Turbo from fal through one Spiral API key. Turn one image into a game-ready 3D mesh in about 20 seconds, with an optional rig and animations. It runs in the background and returns 3D models and images. Pay as you go, with no subscription.

- Provider: fal
- Category: 3D
- Runs: In the background
- Returns: 3d, image
- Tool id: `fal` / `speridlabs/idol/max/turbo`
- Page: https://spiral.ai/tools/fal/speridlabs/idol/max/turbo

## Pricing

Up to $0.13 per run at the default inputs.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 30 minutes
- Longest run, end to end: 225 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `image_url` (required) | URL or file |  | — | URL of the image of a single object to convert into a game-ready 3D mesh. |
| `enable_pbr` | true or false |  | false | Add roughness and metallic maps to the game-ready mesh with a TRELLIS.2 retexture of the preprocessed image; the base color is not changed. Adds typically 20 seconds to 2 minutes. |
| `rig` | true or false |  | false | Also return `rigged_character_glb`: the game-ready mesh with a skeleton and skin weights from SkinTokens, for characters and creatures (bipeds, quadrupeds, winged or tailed). `game_glb` stays without a skeleton. Rigid props such as chests get an unusable skeleton. Adds about 15 seconds (about 60 more on a runner's first such request, which loads the model). |
| `animations` | list |  | [] | Looping clips to write into `rigged_character_glb` as glTF animations; each is also returned alone in a file of the result's `animations`. Requires `rig`. Each is a hand-made animation of a human or of a four-legged animal, played in place on the limbs found from the skeleton and the skin; a clip the skeleton cannot play (walk, run and jump need two legs, or three or four on an animal) is left out, see `rig.animations` in the result. |
| `image_type` | one of | synthetic, real | synthetic | Kind of input image. `synthetic` for renders and generated images (tight crop), `real` for photographs (looser crop). |
| `num_gaussians` | number (whole) | 32768 to 1048576 | 262144 | Target number of Gaussians in the output splat. Rounded down to a multiple of 32. |
| `num_inference_steps` | number (whole) | 1 to 50 | 50 | Number of sampling steps. Fewer are faster but lose some detail. |
| `guidance_scale` | number | 0 to 10 | 3 | Classifier-free guidance: how strictly the object follows the image. |
| `seed` | number (whole) |  | — | Random seed for reproducibility. If None, a random seed is generated. |
| `mesh_resolution` | one of | 128, 256, 512, 768, 1024, 1536 | 1024 | Surface detail. The surface is fused from rendered splat depth on a grid of 0.75 x this many voxels along the object's longest side (1024 -> 768), capped near 80M voxels for bulky objects. Lower values are faster and coarser; above 1024 mostly adds time. |
| `enable_usdz` | true or false |  | false | Also return the game-ready mesh as a USDZ file (`game_usdz`), for AR Quick Look and USD pipelines: same geometry and textures, without a skeleton. |

## Example

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "fal",
    "model": "speridlabs/idol/max/turbo",
    "input": {
      "image_url": "https://v3b.fal.media/files/b/0ab21819/3xTHAXZi41yCcq25k0uZY_YGG7j3lg.png"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=fal&model=speridlabs%2Fidol%2Fmax%2Fturbo

## Common questions

### Idol · Max Turbo

**How much does Idol · Max Turbo cost?**

Up to $0.13 per run at the default inputs. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use Idol · Max Turbo through an API?**

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "speridlabs/idol/max/turbo"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with fal to use Idol · Max Turbo?**

No. Spiral runs it on its own fal account and charges your Spiral balance.

**Can my AI agent use Idol · Max Turbo?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

