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
POST https://luminalocaladjust.usefulweb.app/api/v1/calculate– run Local Photo Adjustments with Masks (Gradient, Radial, Brush, Range)GET https://luminalocaladjust.usefulweb.app/api/v1/tool– inputs, output schema, examples- OpenAPI 3.1: /openapi.json · /openapi.yaml
- Errors:
application/problem+json;422includes per-fielderrors.
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.
| Field | Type | Default | Description |
|---|---|---|---|
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. |
output | select (photo, mask) | "photo" | Download |
maskOf | number | 1 | Adjustment 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)
- Streamable HTTP endpoint:
https://luminalocaladjust.usefulweb.app/mcp– protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake). - Tools:
lumina_local_adjust - Local stdio connector:
node src/mcp-stdio.ts --tool=lumina-local-adjust
{
"mcpServers": {
"lumina-local-adjust": { "type": "http", "url": "https://luminalocaladjust.usefulweb.app/mcp" }
}
}