@koda-sl/baker-cli 0.192.4 → 0.193.0

package/README.md

@@ -1773,6 +1773,8 @@ Each external source is its own subcommand. Pick the verb that matches the sourc
 | `baker images delete <id>` | Delete a record | n/a |
 | `baker images normalize <files>` | Local recolor + bg removal + trim + resize | n/a (operates on disk, no upload) |
 | `baker images upscale <imageId>` | Real-ESRGAN super-resolution via backend ($0.05/image, cost-tracked) | n/a (operates on library image) |
+| `baker images layerize <imageId>` | Split into editable layers — transparent cutouts per element plus baked-in copy recovered as editable text (costs credits) | n/a (operates on library image) |
+| `baker images layers <imageId>` | Read the layers of an already-split image (free) | n/a (operates on library image) |
 | `baker images crop <file>` | Coordinate-based rectangular extract — local file or URL | n/a |
 | `baker images dimensions <file\|url>` | Read width / height / aspect / format without decoding | n/a |
 | `baker images tags` | List available image tag names (defaults + company custom tags) | n/a |
@@ -2251,6 +2253,23 @@ Validation errors return `VALIDATION_ERROR`:
 - Malformed `--color` (must be `#RGB` or `#RRGGBB`)
 - Empty file pattern or no matches
 
+### `baker images layerize <imageId>`
+
+Splits a library image into editable layers and waits for completion (~90s). Returns a transparent PNG per element — each at a permanent URL usable as a canvas input — plus any headline that was drawn into the picture, recovered as real copy with its font, size, weight and colour.
+
+```bash
+baker images layerize j571abc123def
+baker images layerize j571abc123def --full                       # geometry + typography
+baker images layerize j571abc123def --instructions "keep the bottle and its shadow together"
+baker images layerize j571abc123def --max-wait 0                 # fire-and-forget
+```
+
+The model separates what was *visible* and does not repaint what sat behind a subject, so the flat picture is kept as an `Original image` layer underneath.
+
+### `baker images layers <imageId>`
+
+Reads back the layers of an image already split with `layerize`. Free — no provider call. `--full` includes geometry and typography.
+
 ### `baker images upscale <imageId>`
 
 Super-resolution via the Convex backend (Replicate, cost-tracked at $0.05/image). Operates on a library image by ID — upload the file first via `baker images upload`, then upscale.