API & MCP

Everything a person can do on Local Photo Adjustments with Masks (Gradient, Radial, Brush, Range), a program or AI agent can do with the same inputs and get the identical result.

HTTP API

Local Photo Adjustments with Masks (Gradient, Radial, Brush, Range)

Upload a photo and describe up to eight local adjustments as JSON: each has exposure, contrast, highlights, shadows, temperature, tint, saturation, clarity and sharpness and is limited by up to eight masks (linear gradient, radial gradient, brush strokes, luminance range or color range) that add, subtract or intersect. Download the adjusted PNG or the grayscale mask of one adjustment. The Lumina photo editor stores the same JSON in its projects.

Inputs of Local Photo Adjustments with Masks (Gradient, Radial, Brush, Range)
FieldTypeDefaultDescription
image (required)file—Image (PNG, JPEG or WebP; up to 8 MB and 16 MP)
adjustments (required)textarea"[{\"name\":\"Darker sky\",\"settings\":{\"exposure\":-0.8,\"highlights\":-40,\"Local adjustments (JSON list, an object with "local", or a Lumina project). Settings: exposure −3 to 3, the others −100 to 100. Masks: linear (start, end), radial (center, radiusX, radiusY, angle, feather), brush (strokes with size, feather, flow, erase, points), luminance (min, max, feather) and color (color, tolerance, feather); mode add, subtract or intersect; invert.
outputselect (photo, mask)"photo"Download
maskOfnumber1Adjustment number for the mask download

Every result contains

inputs (normalised, defaults applied), summary, result (validated against the published schema), units, assumptions, sources, warnings, computedAt and links.

MCP (Model Context Protocol)

{
  "mcpServers": {
    "lumina-local-adjust": { "type": "http", "url": "https://luminalocaladjust.usefulweb.app/mcp" }
  }
}