Generate 3D Model
sirv_generate_3d_modelGenerate a 3D model from a single product photo for 3D viewers and AR, with selectable topology, PBR textures, and target polygon count.
Instructions
Make a 3D model from one product photo in image_url.
Use it for 3D viewers and AR. Do not use it to make an existing GLB file smaller (use sirv_optimize_glb) or for a depth image only (use sirv_generate_depth_map).
Inputs: model defaults to meshy. topology and target_polycount (default 30000) work with meshy and meshy-multi. enable_pbr works with meshy, meshy-multi and hunyuan3d. The other models ignore them.
Returns model_url (the main file), the other formats by file type, and a thumbnail URL. The request can take up to 20 minutes: keep the connection open for that long.
Credits: spends workspace credits. The cost depends on the model and options.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"image_url": "<image_url>"
},
"name": "sirv_generate_3d_model"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | 3D model generator. Default: meshy | meshy |
| topology | No | Mesh faces: triangle or quad. Default: triangle | triangle |
| image_url | Yes | Public URL of the product photo | |
| enable_pbr | No | true adds PBR (physically based rendering) textures. Default: true | |
| target_polycount | No | Polygons to aim for, 1000 to 200000. Default: the model's own |