Terms used across this API.
- Original
- The exact file you uploaded, stored privately. Never served publicly; only downloadable by the owner via the archive.
- Render
- A generated variant of an image at a specific size and format (e.g. a 2048px webp). Served from the public store. Each render URL carries a
?v=cache-buster. - Preset
- A shared, admin-defined size/format applied to every image (e.g.
thumb,large). Changing a preset re-renders the whole library. - Crop (custom crop)
- A per-image size beyond the shared presets, added by the owner with image.crop.add. Up to five per image. Identified by a
codematching^[a-z0-9][a-z0-9-]{0,31}$. - spec_version
- A per-image counter bumped whenever the render set changes. It is the
?v=value on render URLs, so a regenerate never serves stale bytes from a cache. - EXIF visibility
- Per-image toggles (gps, camera, datetime, settings) controlling which metadata groups are exposed on the public view. Set with image.exif.setVisibility.
- Serve mode
- Whether render URLs point at the public bucket (direct) or are streamed through the app (proxy). See serving modes.
- Personal access token (PAT)
- A long-lived bearer token (prefix
pnt_) for scripts, scoped to theimage.*methods. See authentication.