Skip to content

Speridlabs Idol Max ​

本页列出 ModelFold 模型目录中的参数信息。

概览 ​

字段值
模型 IDsperidlabs-idol-max
所属系列speridlabs-idol-max
模态图像生成 (image)
调用端点POST /v1/images/generations

请求参数 ​

modelstring必填
填 speridlabs-idol-max。
seedinteger可选
Random seed for reproducibility. If None, a random seed is generated.
image_typestring可选
Kind of input image. synthetic for renders and generated images (tight crop), real for photographs (looser crop).
可选值syntheticreal默认synthetic
image_urlstring必填
URL of the image of a single object to convert into a game-ready 3D mesh.
guidance_scalenumber可选
Classifier-free guidance: how strictly the object follows the image.
默认3minimum 0maximum 10
mesh_resolutioninteger可选
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.
可选值12825651276810241536默认1024
num_inference_stepsinteger可选
Number of sampling steps. Fewer are faster but lose some detail.
默认50minimum 1maximum 50
num_gaussiansinteger可选
Target number of Gaussians in the output splat. Rounded down to a multiple of 32.
默认262144minimum 32768maximum 1048576

调用示例 ​

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}'

ModelFold — 一个 API,接入所有主流 AI 模型。