Foil Separation
td_foil_separationCreate a foil-ready plate from a flat, high-contrast design with outline, foiling, dot, or patch modes; results are saved to disk with paths returned.
Instructions
Foil Separation: build the foil layer for the design. Modes outline, foiling (recommended), dot, patch; with or without a vector EPS. Best for: making a foil-ready plate from a flat, high-contrast print design, as clean outlines, distressed foiling line art, dots or accent patches. Result files are saved to disk and their paths returned.
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": "<image>"
},
"name": "td_foil_separation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | Foiling type: outline (Outline): Outline foiling type. foiling (Foiling, Recommended): Standard foiling type. dot (Dot): Dot foiling; optional Add outline or Add foil (one of them) and Dots intensity. patch (Patch): Patch foiling; optional Only patch, Add dots, Avoid negatives, the intensity and Outline thickness. Required: pass the mode the user named. If the user did not name one, omit it and the tool returns the modes to show them; never choose for the user. | |
| wait | No | Wait for the job and save the outputs (default true). false returns the task_id right after submit. | |
| image | Yes | Source image: a local file path or an http(s) URL. PNG, JPEG or WebP, up to 80 MB and 5000 px per side. | |
| vectorize | No | Vectorize: also produce a vector EPS. Default true. | |
| only_patch | No | patch mode: Only patch. Default false. | |
| output_dir | No | Folder to save results in. Default: the folder of the input image (or the current directory for URL inputs). Files are never overwritten. | |
| dots_enabled | No | patch mode: Add dots (not with Only patch). Default false. | |
| dot_intensity | No | Dots intensity: low (Low): Fewer / lighter dots. medium (Medium, Recommended): Medium dot intensity. high (High): Denser dots. Required: pass the mode the user named. If the user did not name one, omit it and the tool returns the modes to show them; never choose for the user. | |
| estimate_only | No | Only return the credit estimate; nothing is uploaded or charged. | |
| avoid_negatives | No | patch mode: avoid negatives. Default false. | |
| foiling_enabled | No | dot mode, Add foil (not with Add outline). Default false. | |
| outline_enabled | No | dot mode, Add outline (not with Add foil). Default false. | |
| patch_intensity | No | Patch / Outline intensity: low (Low): Lighter patches. medium (Medium, Recommended): Medium patch intensity. high (High): Heavier patches. Required: pass the mode the user named. If the user did not name one, omit it and the tool returns the modes to show them; never choose for the user. | |
| review_settings | No | Omit it and the tool first asks whether to use the recommended settings or adjust them (unless the call already sets some). true: ask each setting one by one. false: run with the given or recommended settings without asking; pass it only after the user chose that. | |
| timeout_seconds | No | How long to wait for the job before returning its task_id (default 240). | |
| unlimited_bundle | No | Request the Unlimited bundle for this run (only has effect on Unlimited plans; the server decides). | |
| outline_thickness | No | patch mode Outline thickness 8-15 px (only without Only patch and Add dots). Default 11. |