Spiral gives your agent every tool with one account. Browse the tools →

fal3DAvailable now

Idol · Max Turbo

speridlabs/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.

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

FieldKindDefaultDescription
image_url requiredURL or file—

URL of the image of a single object to convert into a game-ready 3D mesh.

enable_pbrtrue or falsefalse

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.

rigtrue or falsefalse

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).

animationslist[]

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_typeone of
synthetic, real
synthetic

Kind of input image. synthetic for renders and generated images (tight crop), real for photographs (looser crop).

num_gaussiansnumber (whole)
32768 to 1048576
262144

Target number of Gaussians in the output splat. Rounded down to a multiple of 32.

num_inference_stepsnumber (whole)
1 to 50
50

Number of sampling steps. Fewer are faster but lose some detail.

guidance_scalenumber
0 to 10
3

Classifier-free guidance: how strictly the object follows the image.

seednumber (whole)—

Random seed for reproducibility. If None, a random seed is generated.

mesh_resolutionone 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_usdztrue or falsefalse

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.

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.