Speridlabs Idol Max
This page lists parameters from the ModelFold model catalog.
Overview
| Field | Value |
|---|---|
| Model ID | speridlabs-idol-max |
| Family slug | speridlabs-idol-max |
| Modality | Image Generation (image) |
| Endpoint | POST /v1/images/generations |
Request parameters
modelstringRequiredUse
speridlabs-idol-max.seedintegerOptionalRandom seed for reproducibility. If None, a random seed is generated.
image_typestringOptionalKind of input image.
synthetic for renders and generated images (tight crop), real for photographs (looser crop).image_urlstringRequiredURL of the image of a single object to convert into a game-ready 3D mesh.
guidance_scalenumberOptionalClassifier-free guidance: how strictly the object follows the image.
mesh_resolutionintegerOptionalSurface 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.
num_inference_stepsintegerOptionalNumber of sampling steps. Fewer are faster but lose some detail.
num_gaussiansintegerOptionalTarget number of Gaussians in the output splat. Rounded down to a multiple of 32.
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","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}'