image-edit

1# Image Edit
2 
3Edit an existing image with `image_edit` — a local, deterministic pixel pipeline. No AI model and no credits for `image_edit` itself; the auxiliary `probe_image_metadata` call is billed per use. The result is pixel-exact and repeatable.
4 
5This is **fine-grained image editing**: unlike AI re-creation (`image-creation`), every operation is pixel-exact. Precision is the premise — free-crop regions, mosaic areas, watermark/overlay positions, and drawn shapes are source-image pixel coordinates, so always work from the real dimensions returned by `probe_image_metadata`, never from guesses.
6 
7## Tool
8 
9- `image_edit`: one call per image. Pass `url` (source image) plus `operations`, an ordered array of 1–20 operations applied in sequence.
10- `probe_image_metadata` (auxiliary): read the source image's real width/height, format, and size with `info_type=metadata` (default). When transparency matters, use `info_type=alpha`; it also returns width/height/format, so do not call metadata first unless size is also required. Each probe is billed; do not call it again for the same URL.
11- Output: `url` (edited image), `width`, `height`, `format`, `sizeBytes`.
12- `compress` must be the **last** operation (it is the export step).
13- Operations that introduce transparency (circle crop, rounded corners) output PNG with alpha.
14 
15Do not call other image CLIs, local scripts, or external image APIs.
16 
17## When to use
18…