Convert, compress or repair a Library model
convert_modelConvert one of the account’s Library 3D models (a GLB, OBJ or STL file) to GLB, STL, 3MF, OBJ or PLY on the server, optionally simplifying it, compressing its geometry, scaling it to a real-world size, moving its origin or repairing it for printing (holes, flipped faces, debris; STL, 3MF, OBJ or PLY), and file the result in the Library as a new creation made from it. Free (no credits) and answered at once. STL and 3MF are millimetres and Z-up for slicers; OBJ and PLY are geometry only, in metres; GLB keeps materials and textures and can be meshopt-compressed. Name exactly one source: asset_id, from get_job or search_library (a file of a finished 3D job), or uploaded_file_id, the asset_id canvas_upload_commit answered for a GLB, OBJ or STL you uploaded (with board_id when it is on a Canvas Studio board, where a teammate's file that board holds may be converted too). Models over 50 MB or 2,000,000 triangles, and Draco-compressed GLBs, are refused. An OBJ is read alone, as geometry (no mtl or texture), and an STL as millimetres, Z-up. The same conversion run twice returns the same creation.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "convert_model"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | ||
| format | No | The file to make; glb when omitted. | |
| origin | No | Move the origin to the bottom centre (default when resizing) or the centre. | |
| repair | No | Repair for printing first: weld, drop broken and duplicate faces and loose debris, fix flipped faces, fill holes. stl, 3mf, obj, ply only; up to 200,000 triangles (simplify first for more). | |
| asset_id | No | A GLB, OBJ or STL file of one of your Library models. Exactly one of asset_id and uploaded_file_id. | |
| board_id | No | The Canvas Studio board the file is on: a teammate’s file is read only from a board that shows it and that you may run on. | |
| simplify | No | Share of triangles to keep: 1 (default), 0.75, 0.5 or 0.25. | |
| project_id | No | ||
| compression | No | GLB only: meshopt (default, smallest) or none. | |
| resize_height | No | Scale the model to this height, in metres. | |
| uploaded_file_id | No | A GLB, OBJ or STL file you uploaded: the `asset_id` canvas_upload_commit answered. Exactly one of asset_id and uploaded_file_id. | |
| resize_longest_side | No | Scale the model so its longest side is this long, in metres. Not with resize_height. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Public https download URL of the file. | |
| format | Yes | ||
| job_id | Yes | The new Library creation: pass to get_job like any job. | |
| repair | No | What repair found and fixed, when repair was asked for. | |
| created | Yes | False when the same conversion was already in the Library: that creation is returned. | |
| asset_id | Yes | Its file, for another convert_model. | |
| size_bytes | Yes | ||
| content_type | Yes | ||
| triangles_after | Yes | ||
| triangles_before | Yes |