describe_scene
Read-only
Return a SAR-literate reading of the scene at url.
The picture and the metadata card are produced deterministically; a model
only interprets them. How that model is reached depends on whether this
process holds a vision key:
- **No key** (the public community host): this tool does **not** call a
vision model. It returns the PNG plus a reading kit (SAR rules, the
metadata card, the JSON schema). Produce the JSON, then call
:func:`stamp_description` — that is the validation boundary
(provenance-stamped ``{summary, observed_features, confidence,
caveats}``). Until you stamp it, your prose is not pipeline output.
A baked preview is typically 512 px; the kit names the size and
that a local server can stream a higher-resolution GeoTIFF.
- **Key configured** (local stdio): sends the picture to that vision
model, validates through ``parse_description``, and returns the
stamped object directly.
The packaged SAR rules are the value over just looking at ``quicklook``:
brightness is backscatter not sunlight, speckle is not structure, a dark
patch may be radar shadow not water, one frame is not change.
``preview`` defaults to ``"auto"``: a baked catalog preview if this server
has one, else a fresh render. ``"render"`` is refused on the public host.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| db | No | ||
| url | Yes | ||
| asset | No | GEC | |
| model | No | ||
| preview | No | auto | |
| max_size | No |