download_object
Download a Sand3D object's GLB, render, metadata, and source files into a chosen folder, with optional USDA and three.js joint helper outputs.
Instructions
Download one Sand3D object into a folder the user chose: model.glb, program.py, render.png (512x512, transparent) and meta.json with license and attribution; model.usda too when include_usda=true or when the object has no GLB. Files go to /; existing files with the same names are overwritten. Returns paths, sizes, GLB stats (meters, Y up), part names, joints and the attribution string to credit (CC BY 4.0). include_threejs_helper=true also writes s3d-joints.js (collectJoints, setJoint, setJoint01, fitToHeight). Only writes inside the given directory. Runs against a free single-CPU space by Sandflow: fine for dozens of objects; for bulk work use the open Hugging Face datasets Sandflow/sand3d-*.
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": {
"object_id": "<object_id>",
"directory": "<directory>"
},
"name": "download_object"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| directory | Yes | Target root folder, absolute path or relative to the client's working folder, e.g. 'assets/sand3d'. Ask the user if unsure. | |
| object_id | Yes | Object id from search_objects or find_similar. | |
| subfolder | No | Subfolder name inside directory. Default is '<name-slug>-<hash>' from the object name. | |
| include_usda | No | Also download model.usda from the Hugging Face dataset. | |
| include_threejs_helper | No | Also write s3d-joints.js, a three.js helper for joints and scaling. |