Make sure you add your s3 details for 3d server, so you can receive image generated in your bucket. Images generated without s3 details being added will be delete after 24hours

​
Request

Make a POST request to below endpoint and pass the required parameters as a request body.
curl
--request POST 'https://modelslab.com/api/v1/enterprise/3d/text_to_3d' \

​
Body

json
{    
  "key": "enterprise_api_key",    
  "foreground_ratio": "0.85",    
  "prompt": "a ghost wearing white bedsheet",    
  "num_inference_steps": "30",    
  "resolution": 512,    
  "guidance_scale": "3",    
  "ss_sampling_steps": 50,    
  "slat_sampling_steps": 50,    
  "output_format":"glb",    
  "seed": 0,    
  "temp": "no",    
  "webhook": null,    
  "track_id": null
}

​
Body Attributes

​
key
string
required
Your API Key used for request authorization.
​
model_id
string
default:"instantmesh"
Specifies the model to be used for the 3D generation.
​
prompt
string
default:"A full body mesh of a dog"
required
Text prompt for generating the 3D model.
​
render
bool
default:"false"
Whether to render a NeRF video of the 3D model.
​
output_format
string
default:"obj"
The format of the output 3D object (glb, obj, stl, ply).
​
negative_prompt
string
default:""
Negative prompt to exclude certain elements.
​
guidance_scale
number
default:"1"
Controls the guidance between the prompt and the generated model.
​
num_inference_steps
number
default:"10"
required
The number of inference steps to generate the 3D model.
​
ss_guidance_strength
number
default:"7.5"
Controls the strength of style-space guidance.
​
ss_sampling_steps
number
default:"12"
Number of sampling steps for style-space guidance. Range: 1 to 50.
​
slat_guidance_strength
number
default:"3.0"
Controls the strength of slat guidance. Range: 0.0 to 10.0.
​
slat_sampling_steps
number
default:"12"
Number of sampling steps for slat guidance. Range: 1 to 50.
​
mesh_simplify
number
default:"0.90"
Degree of mesh simplification. Range: 0.90 to 0.98.
​
foreground_ratio
number
default:"0.85"
required
Ratio of the foreground size to the image size. Only used when remove_bg is enabled.
​
remove_bg
bool
default:"false"
If true, removes the background from the generated 3D model.
​
resolution
number
default:"256"
required
Specifies the resolution of the generated 3D model. Max: 512.
​
chunk_size
number
default:"8192"
Size of chunks used in the process (affects VRAM usage). Max: 12000.
​
seed
number
default:"0"
Random seed for reproducibility. If set to 0, a random seed will be generated.
​
temp
string
default:"no"
If set to "yes", the output files will be saved in a temporary directory.