Skip to content

Speridlabs Idol Max Turbo ​

This page lists parameters from the ModelFold model catalog.

Overview ​

FieldValue
Model IDsperidlabs-idol-max-turbo
Family slugsperidlabs-idol-max-turbo
ModalityImage Generation (image)
EndpointPOST /v1/images/generations

Request parameters ​

modelstringRequired
Use speridlabs-idol-max-turbo.
seedintegerOptional
Random seed for reproducibility. If None, a random seed is generated.
image_typestringOptional
Kind of input image. synthetic for renders and generated images (tight crop), real for photographs (looser crop).
AllowedsyntheticrealDefaultsynthetic
image_urlstringRequired
URL of the image of a single object to convert into a game-ready 3D mesh.
guidance_scalenumberOptional
Classifier-free guidance: how strictly the object follows the image.
Default3minimum 0maximum 10
mesh_resolutionintegerOptional
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.
Allowed12825651276810241536Default1024
num_inference_stepsintegerOptional
Number of sampling steps. Fewer are faster but lose some detail.
Default50minimum 1maximum 50
num_gaussiansintegerOptional
Target number of Gaussians in the output splat. Rounded down to a multiple of 32.
Default262144minimum 32768maximum 1048576

Request example ​

bash
export API_BASE="https://modelfold.ai/v1"
export MODELFOLD_API_KEY="mf-..."   # 在控制台 API Key 页面创建
curl -X POST "$API_BASE/images/generations" \
  -H "Authorization: Bearer $MODELFOLD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"speridlabs-idol-max-turbo","image_url":"https://example.com/reference.png","image_type":"synthetic","guidance_scale":3,"mesh_resolution":1024,"num_inference_steps":50,"enable_safety_checker":true,"num_gaussians":262144}'

ModelFold — one API for all the best AI models.