API & MCP
Everything a person can do on Lens Distortion, Color Fringe & Vignetting Correction, a program or AI agent can do with the same inputs and get the identical result.
HTTP API
POST https://luminalenscorrect.usefulweb.app/api/v1/calculate– run Lens Distortion, Color Fringe & Vignetting CorrectionGET https://luminalenscorrect.usefulweb.app/api/v1/tool– inputs, output schema, examples- OpenAPI 3.1: /openapi.json · /openapi.yaml
- Errors:
application/problem+json;422includes per-fielderrors.
Lens Distortion, Color Fringe & Vignetting Correction
Upload a photo and correct barrel or pincushion lens distortion with a two-term radial model, align the red and blue channels to reduce lateral color fringes, and brighten or darken the corners in linear light. Automatic scaling fills the frame without empty corners. Download a PNG plus the settings as JSON for the Lumina photo editor, where the same correction stays editable.
| Field | Type | Default | Description |
|---|---|---|---|
image (required) | file | — | Image (PNG, JPEG or WebP; up to 8 MB and 16 MP) |
distortion | number | 25 | Distortion (positive corrects barrel, negative pincushion). −100 to 100. The radial term k1 = −0.0025 × value. |
edge | number | 0 | Edge distortion (extra correction near the corners). −100 to 100. The 4th-order term k2 = −0.001 × value. |
red | number | 0 | Red fringe (positive shrinks the red channel). −100 to 100; 100 scales the red channel radius by 0.2 %. |
blue | number | 0 | Blue fringe (positive shrinks the blue channel). −100 to 100; 100 scales the blue channel radius by 0.2 %. |
vignette | number | 0 | Corner brightness (EV × 100 in the corners). −100 to 100; 100 brightens the corners by one stop in linear light. |
autoScale | boolean | true | Fill the frame automatically |
scale | number | 100 | Manual scale (%) when automatic scaling is off |
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://luminalenscorrect.usefulweb.app/mcp– protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake). - Tools:
lumina_lens_correct - Local stdio connector:
node src/mcp-stdio.ts --tool=lumina-lens-correct
{
"mcpServers": {
"lumina-lens-correct": { "type": "http", "url": "https://luminalenscorrect.usefulweb.app/mcp" }
}
}