Render a material swatch
art_swatchRenders one material (a shipped id, or a whole material document) as a lit square swatch PNG. size is 64 to 1024 (default 512); 512 or less costs 1 unit, larger costs 2.
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": {
"material": "<material>"
},
"name": "art_swatch"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| size | No | Swatch side in pixels, 64 to 1024 (default 512). Above 512 costs more. | |
| material | Yes | A shipped material id (art_materials lists them) or a whole material document written inline. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ms | No | Milliseconds the run took. | |
| job | Yes | The job id; the job tool reads it. | |
| verb | No | The tool that made it. | |
| files | No | Files made, each with a name, type, size and a signed URL. | |
| units | No | Units this call cost. | |
| result | No | The engine's own answer, a JSON document. | |
| status | No | queued when the job runs in the background. |