Idol · Max Turbo
speridlabs/idol/max/turboTurn 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.
Pricing
Up to $0.13 per run at the default inputs.
Limits
- Runs
- In the background
- Returns
- 3d, image
- 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 | 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 |
animations | list | [] | Looping clips to write into |
image_type | one of synthetic, real | synthetic | Kind of input image. |
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 ( |
Same request in code
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"
}
}'Frequently asked questions
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.