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

fal3DAvailable now

Idol Max · Image to 3D

speridlabs/idol/max

Turn images into 3D models with Idol Max · Image to 3D from fal through one Spiral API key. Turn one image into a game-ready 3D mesh with clean geometry and a sharp repainted texture, 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.26 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",
    "input": {
      "image_url": "https://v3b.fal.media/files/b/0ab21819/3xTHAXZi41yCcq25k0uZY_YGG7j3lg.png"
    }
  }'

Frequently asked questions

How much does Idol Max · Image to 3D cost?

Up to $0.26 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 · Image to 3D through an API?

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "speridlabs/idol/max"` 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 · Image to 3D?

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

Can my AI agent use Idol Max · Image to 3D?

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